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PREFACE 



PURPOSE 

This handbook describes the installation of the CONTROL DATA® Network Operating System (NOS) 
Version 2.4.1 and its products. NOS controls the operation of the following Computer ■ 
Systems: 

• CDC® CYBER 180 Computer Systems 

Models 810, 830, 835, 840, 845, 850, 855, and 860 | 

• CDC CYBER 170 Computer Systems 

Models 171, 172, 173, 174, 175, 176, 720, 730, 740, 750, 760, 815, 825, 835, 845, I 
855, 865, and 875 | 

• CDC CYBER 70 Computer Systems 
Models 71, 72, 73, and 74 

• CDC 6000 Computer Systems 



AUDIENCE 

Because there are two methods for installing NOS and its product set, this handbook was 
written for two types of users: installers of a standard system and installers of a 
customized system. 

If you will be installing a standard system (that is, you will not be modifying the 
software), you should be familiar with the basic operations of a Control Data computer. For 
example, you should know how to assign and label tapes and how to enter commands at the 
system console. For this information, refer to the NOS Operations Handbook and the NOS 
Reference Set Volume 3. 

If you will be customizing the software during installation, you should be familiar with 
NOS, COMPASS, and each product you are customizing. In other words, you should be familiar 
with the information provided in the NOS 2 Analysis Handbook and with the information 
provided in reference manuals for the products you are customizing. 



MANUAL ORGANIZATION 

This handbook describes the software installation of NOS and its entire product set. You 
can disregard any information about products you have not ordered. 

This handbook is organized in the following manner: 

• Section 1 briefly describes standard and customized installations and suggests how 
to prepare for either one. 

• Section 2 describes how to install a standard system using the released deadstart 
tape. If you do not need to customize NOS or any products, follow the procedure 
detailed in this section. 
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• Sections 3 and 4 describe how you can install a customized system by building 
products from the source code on the permanent file dump tape. Because this method 
of installation is complex, you should use this method only if necessary. To use 
this method, you should be familiar with NOS and the products you are installing. 

• Section 5 contains special information for customized installation procedures for 
NOS and each of its products. Before building products, refer to this section for 
details concerning a specific installation procedure. 

• The six appendixes contain reference information: a glossary of terms; a list of 
installation commands, parameters, and procedures; the file formats of the source 
materials; controlware installation; special information for 63-character set 
installation; and Remote Diagnostic Facility information. 

CONVENTIONS 

The following conventions are used throughout this handbook: 

• CYBER 170 and 180 Computer Systems that share functional and architectural 
attributes are called CYBER 180-class machines. For example, the CYBER 180 Computer 
Systems and the CYBER 170 Models 815, 825, 835, 845, and 855 are called CYBER 
180-class machines. 

• The term CYBER 70 Computer Systems refers to models 71, 72, 73, and 74 only. 

• The terms command and control statement are interchangeable. 

• Extended memory for model 176 is large central memory extended (LCME). Extended 
memory for the CYBER 180-class machines is unified extended memory (UEM). Extended 
memory for models 865 and 875 includes unified extended memory and may also include 
extended core storage (ECS) or extended semiconductor memory (ESM). Extended memory 
for all other NOS computer systems is either ECS or ESM. ECS and ESM are the only 
forms of extended memory that can be shared in an ECS multimainframe complex and can 
be accessed by a distributive data path (DDP). 

• ECS refers to both ECS and ESM, and extended memory refers to all forms of extended 
memory unless otherwise noted. However, when referencing extended memory in the 
context of an ECS multimainframe complex or DDP access, UEM and LCME are excluded. 

• Uppercase letters within command formats must be entered exactly as given; replace 
lowercase letters with appropriate characters as described in the text. 



• 



At all sites, you must specify Job and USER commands. The CHARGE command is not 
required at all sites. 

Press CR means press the carriage return key on the CC545 console or press the NEXT 
key on the CC634B console. 
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SUBMITTING COMMENTS 

The last page of this manual is a comment sheet. Use the comment sheet to suggest specific 
improvements for the manual and to report any errors. If the comment sheet has already been 
used, you can mail your comments to: 

Control Data Corporation 

Publications and Graphics Division 

ARH219 

4201 Lexington Avenue South 

St. Paul, MN 55112 

If you have access to SOLVER, an online problem reporting facility, you can use it to submit 
comments about the manual. Declare your problem type as DOC and use NS2 as the product 
identifier. 



RELATED PUBLICATIONS 

Control Data manuals are available through Control Data sales offices or Control Data 
Literature and Distribution Services (308 North Dale Street, St. Paul, Minnesota 55103). 

The NOS Version 2 Manual Abstracts (publication number 60485500) is a pocket-sized manual 
containing brief descriptions of the contents and intended audience of all NOS 2 manuals and 
optional product manuals. 

Control Data also publishes a Software Publications Release History (publication number 
60481000) of all software manuals and revision packets it has issued. This history lists 
the revision level of a particular manual that corresponds to the level of software 
installed at the site. 

Programming information for the various forms of extended memory can be found in the COMPASS 
Reference Manual and in the appropriate computer system hardware reference manual. 



EXTENDED MEMORY MANUALS 

Publication 
Control Data Publication Number 



Extended Semiconductor Memory Hardware Reference Manual 60455990 

Extended Core Storage Reference Manual 60347100 

Extended Core Storage II and Distributive Data Path Reference Manual 60430000 
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NOS 2 MANUALS 

Publication 
Control Data Publication Number 

Common Memory Manager Version 1 Reference Manual 60499200 

COMPASS Version 3 Reference Manual 60492600 

CYBER Initialization Package (CIP) User's Handbook 60457180 

CYBER Loader Version 1 Reference Manual 60429800 

CYBER Record Manager Advanced Access Methods Version 2 Reference Manual 60499300 

CYBER Record Manager Basic Access Methods Version 1 Reference Manual 60495700 

CYBER Supermini Operations Handbook 60459850 

FORM Version 1 Reference Manual 60496200 

Modify Version 1 Reference Manual 60450100 

NOS Version 2 Administration Handbook 60459840 

NOS Version 2 Analysis Handbook 60459300 

NOS Version 2 Applications Programmer's Instant 60459360 

NOS Version 2 Diagnostic Index 60459390 

NOS Version 2 Network Terminal User's Instant 60459380 

NOS Version 2 Operations Handbook 60459310 

Nos Version 2 Applications Installation Handbook 84002760 

NOS Version 2 Reference Set, Volume 3, Systems Commands 60459680 

NOS Version 2 Reference Set, Volume 4, Program Interface 60459690 

NOS Version 2 Systems Programmer's Instant 60459370 

NOS Version 2 Security Administrator's Handbook 60460410 

On-Line Maintenance Software Reference Manual 60454200 

SYMPL Version 1 Reference Manual 60496400 
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OPTIONAL PRODUCT MANUALS 



Control Data Pu blication 

ALGOL-60 Version 5 Reference Manual 

APL Version 2 Reference Manual 

BASIC Version 3 Reference Manual 

COBOL Version 5 Reference Manual 

Concurrent Maintenance Library Reference Manual 

Conversion Aids System Version 3 Reference Manual 

CYBER Cross System Version 1 Build Utilities Reference Manual 

CYBER Cross System Version 1 Macro Assembler Reference Manual 

CYBER Cross System Version 1 Micro Assembler Reference Manual 

CYBER Cross System Version 1 PASCAL Reference Manual 

CYBER Interactive Debug Version 1 Reference Manual 

Data Catalogue 2 Version 2 Reference Manual 

DMS-170 CYBER Database Control System Version 2 
Data Administration Reference Manual 

DMS-170 CYBER Database Control System Version 2 
Application Programming Reference Manual 

DMS-170 Query Update/CYBER Record Manager 
Data Administration Reference Manual 

FORTRAN Data Base Facility Version 1 Reference Manual 

FORTRAN Extended Version 4 Common Library 
Mathematical Routines Reference Manual 

FORTRAN Extended Version 4 Reference Manual 

FORTRAN Extended Version 4 to FORTRAN Version 5 
Conversion Aids Program Version 1 Reference Manual 

FORTRAN Version 5 Common Library Mathematical Routines Reference Manual 

FORTRAN Version 5 Reference Manual 

MSSI Version 3 Reference Manual 

MSSI Version 3 Installation Handbook 



Publication 
Number 

60481600 
60454000 
19983900 
60497100 
60455980 
19265358 
60471200 
96836500 
96836400 
96836100 
60481400 
60483350 

60485200 

60485300 

60482100 
60482200 

60498200 
60497800 

60483000 
60483100 
60481300 
60458820 
60458830 
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Control Data Publication 

Message Control System Version 1 Reference Manual 

Network Access Method Version 1 /Communications Control Program 
Version 3 Host Application Programming Reference Manual 

Network Access Method Version 1 /Communications Control Program 
Version 3 Terminal Interfaces Reference Manual 

Network Definition Language Version 1 Reference Manual 

NOS Version 2 Applications Installation Handbook 

NOS Full Screen Editor User's Guide 

PASCAL Version 1.1 Reference Manual 

PL/I Version 1 Reference Manual 

Query Update Version 3 Reference Manual 

Remote Batch Facility Version 1 Reference Manual 

Remote Host Facility Access Method Reference Manual 

Screen Formatting Reference Manual 
| STIMULA 1 Reference Manual 

Sort/Merge Versions 4 and 1 Instant Manual 

Sort/Merge Versions 4 and 1 Reference Manual 

Sort/Merge Version 5 Reference Manual 

TAF Version 1 Reference Manual 

TAF/CRM Data Manager Version 1 Reference Manual 

Text Editor Version 1 Reference Manual 

Update Version 1 Reference Manual 

XEDIT Version 3 Reference Manual 
| 5870 Printer Site Reference Manual 

8-Bit Subroutines Version 1 Reference Manual 



Publication 
Number 

60480300 



60499500 

60480600 

60480000 

84002760 

60460420 

60497700 

60388100 

60498300 

60499600 

60459990 . 

60460430 

60234800 

60497600 

60497500 
60484800 
60459500 
60459510 
60436100 
60449900 
60455730 
60462710 
60495500 
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HARDWARE MANUALS 



Publication 

Control Data Publicati on __ Number 

CYBER 70 Computer System Model 71 Hardware Reference Manual 60453300 

CYBER 70 Computer System Model 72 Hardware Reference Manual 60347000 

CYBER 70 Computer System Model 73 Hardware Reference Manual 60347200 

CYBER 70 Computer System Model 74 Hardware Reference Manual 60347400 

CYBER 170 Computer System Hardware Reference Manual 60420000 

CYBER 170 Computer Systems Models 720, 730, 740, 750, 760, and 176 

Level B/C Hardware Reference Manual 60456100 

CYBER 170 Computer System Models 815 and 825 Hardware Reference Manual 60469350 

CYBER 170 Computer Systems Models 865 and 875 

Hardware Reference Manual 60458920 

CYBER 170/180 Computer Systems Models 835, 845, and 855 

Hardware Operator's Guide 60458390 

CYBER 170/180 Computer Systems Models 835, 840, 845, 850, 855, 

860, and 990 (CYBER 170-State) Hardware Reference Manual 60469290 

CYBER 180 Computer Systems Models 810 and 830 (CYBER 170- 
State) Hardware Reference Manual 60469420 

CYBER 180 Computer Systems Models 810 and 830 Hardware Operator's Guide 60469440 

380-170 Network Access Device Hardware Reference Manual 60458500 

6400/6500/6600 Computer Systems Reference Manual 60100000 

2550-2 Host Communication Processor Hardware Reference Manual 74375500 
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DISCLAIMER 

N0S and its product set are intended to be 
used only as described in this document. 
Control Data cannot be responsible for the 
proper functioning of undescribed features 
or parameters. 
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INTRODUCTION 



WHAT IS INSTALLATION? 

Installation is the process of creating an operating system deadstart file and then loading 
the system. Loading the system means copying the information on the deadstart file to 
specific locations in central memory and to disk. The deadstart file, which can reside on 
tape or disk, contains binary information created by assembling operating system and product 
set source code. 

In addition to the information on the deadstart file, you must also copy several permanent 
files to disk. Most of the permanent files you need are released on the permanent file 
tapes. You create the rest of the permanent files by executing various installation 
procedures . 



STANDARD AND CUSTOMIZED INSTALLATIONS 

CDC releases NOS and all the products you have ordered on the deadstart tape. This tape has 
been tailored according to the information you provided in the Order Information Package 
(OIP). 

Using the released deadstart tape to install the system is a standard installation. 
Standard installation requires a minimum number of steps. By using it, you do not have to 
build products from source code, nor do you have to verify the installation; CDC has already 
performed those procedures for you. Section 2 tells you how to install a standard system. 

If you need to modify NOS or any products, you can do so by building products from source 
code. This is a customized installation. A customized installation is complex and requires 
many procedures; it also requires more time to perform than a standard installation. Note, 
however, that all products are prebuilt by CDC and released on the deadstart tape, so you 
need only build the products you want to customize. Sections 3, 4, and 5 describe how to 
install a customized system. 
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PREPARING FOR AN INSTALLATION 

To perform either a standard or customized installation you need to: 

• Ensure that CIP has been installed to disk. 

• Collect all release tapes. 

• Collect and update manuals* 

• Read all release bulletins. 

These tasks are described in the following paragraphs. 

ENSURE THAT CIP HAS BEEN INSTALLED TO DISK 

The CYBER Initialization Package (CIP) tape contains hardware and software interface modules 
that allow NOS to run on a CYBER mainframe. CIP is released separately from your NOS order 
and is sent to your customer engineer (CE). If you have an 800 series computer, the CIP 
modules must be installed to disk. If you have a non-800 series computer, installing the 
CIP modules is optional. Check with your CE to ensure that CIP has been installed; CIP 
installation should be a cooperative effort between you and your CE. 

COLLECT ALL RELEASE TAPES 

You need these tapes to install NOS and any optional products: 

• Deadstart Tape 

This tape contains all the executable programs for NOS and the products you have 
ordered. These programs were built according to the information you specified in 
the OIP. 

• Permanent File Tapes 

The permanent file tapes contain the permanent files your system needs to run. 
(These tapes also contain the source code for your system. You can use the source 
code if you want to perform a customized installation.) 



1 NOTE 



If you ordered only a software component 
(and not NOS), the executable programs and 
source code for your component order are 
released on permanent file tapes. 
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COLLECT AND UPDATE MANUALS 

A complement of manuals is sent with each release. Manuals that have been completely 
revised since the last edition have a yellow cover sheet. You can discard your last edition 
of these manuals. Revision packets, if any, have a pink cover sheet. The pink cover sheet 
explains which pages are to be inserted or removed from the last edition of the manual. 

In addition to using this handbook, you may need to refer to the following publications 
while performing an installation: 

Publication 
Control Data Publication Number 



NOS Version 2 Administration Handbook 60459840 

NOS Version 2 Analysis Handbook 60459300 

CYBER Initialization Package (CIP) User's Handbook 60457180 

NOS Version 2 Reference Set, Volume 3, System Commands 60459680 

NOS Version 2 Operations Handbook 60459310 

NOS Version 2 Systems Programmer's Instant *• 60459370 

READ ALL RELEASE BULLETINS 

There are two types of documents you should read before performing an installation: the 
Software Release Bulletin and any Installation Bulletins. 

A Software Release Bulletin (SRB) is issued with each NOS release. This bulletin, which is 
issued after this handbook, contains up-to-the-minute information that is specific to the 
release. 

A printed copy of the SRB is included with your release materials. In addition, a file copy 
of the SRB is released on the permanent file tape(s). The file (named SRB) is loaded to the 
installaton user name INSTALL by X.SYSGEN(FULL). 

Installation Bulletins (IBs) may be issued to communicate information that is discovered 
after the release has been forwarded to customers. You can access IBs through SOLVER. 

SOLVER is an interactive program that allows you to access the Programming Systems Report 
(PSR) database. By using SOLVER, you can: 

• List IBs associated with the system you are installing. 

• Report software problems to CDC. 

• Check the status of problem reports. 

• Search for duplicate problem reports submitted by other customers. 

You can access SOLVER through direct dial or Telenet lines. Contact your local CDC 
Professional Services office for complete access information. 
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INSTALLING A STANDARD SYSTEM 



This section describes how to install a standard (unmodified) system for both a full product 
order and for a component order. 

A full product order is an order that includes NOS. If your order includes NOS, you receive 
a deadstart tape and permanent file tapes. To install a full product order, follow the 
steps in Full Product Order Installation. 

After ordering and installing this release of NOS, you may decide to order additional 
products. This is called a component order. For a component order, you receive only the 
permanent file tapes. You need to use your deadstart file from the previous full product 
order of the same PSR level. To install a component order, follow the steps in Component 
Order Installation. 
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FULL PRODUCT ORDER INSTALLATION 

A full product order Installation consists of the following four steps, which are described 
In detail In this section. 

Step 1: Deadstart your system using the released deadstart tape. 

Step 2: Install the permanent files necessary for running NOS. 

Step 3: Create and move necessary configuration files. 

Step 4: Create a new deadstart file. 
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STEP 1 : DEADSTART USING THE RELEASED DEADSTART TAPE 

During the deadstart process, you must define your hardware configuration and other system 
attributes by making entries to the deadstart decks on the deadstart tape. CDC provides you 
with a set of preconfigured deadstart decks. These preconfigured decks are listed in the 
Software Release Bulletin (SRB). 

When you deadstart the system, use the deadstart decks that most closely match your 
particular configuration. Once you have deads tarted the system using the preconfigured 
decks, you must then modify the decks for your particular hardware configuration. For 
example, you need to make entries to specify the number and type of disk and tape units 
connected to your computer. Here is a brief description of each deck. 

• CMRDECK (Central Memory Resident Deck). A CMRDECK is a text record on the deadstart 
tape. The entries in this deck describe the central memory table sizes to be used 
by the system; this deck also specifies which EQPDECK, IPRDECK, and LIBDECK is used 
by the system. 

• EQPDECK (Equipment Deck). An EQPDECK is a text record on the deadstart tape. The 
entries in this deck describe the hardware connected to your computer. These 
entries are used by the system to build the equipment status table (EST). 

• IPRDECK (Installation Parameters Deck). An IPRDECK is a text record on the 
deadstart tape. The entries in this deck describe the default mode of system 
operation. 

• LIBDECK (Library Edit Deck). A LIBDECK is a SYSEDIT directive record on the 
deadstart tape. The entries in this deck specify program residence, field length, 
record type, and parameter format. This deck cannot be modified during the 
deadstart process. 

Write down any deadstart deck entries you make during the deadstart process. You will need 
this information in Step 4, Creating a New Deadstart File. 

The NOS 2 Operations Handbook contains detailed explanations of the deadstart process; the 
NOS 2 Analysis Handbook contains detailed descriptions of the deadstart decks. 

To deadstart your system, follow these steps: 

1. Mount the deadstart tape on an available tape unit. 

2. Set your deadstart panel (or deadstart display) to specify a level deadstart from 
the preconfigured CMRDECK. you want to use to deadstart your system. (For detailed 
information about setting the deadstart panel, refer to the NOS 2 Operations 
Handbook. ) 

• For CYBER 800 series computers, set up the panel for a disk deadstart from the 
disk unit that contains CYBER Initialization Package (CIP). 

• For non-800 series computers (where no CIP has been installed), specify a tape 
deadstart from the unit where you mounted the deadstart tape. 
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3. Initiate the deadstart sequence. 

• If you are using the CC545 console, press the deadstart button. 

• If you are using a CC634B console, press the RESET key to reinitialize the 
console. Next, press CTRL G and then press CTRL R. 

• For models 810, 815, 825, and 830, press CR to advance to the Initial Options 
display. 

• For all other models, the Initial Options display appears after you initiate the 
deadstart sequence. 

4. When the Initial Options display appears, do one of the following: 

• For all CYBER 800 series computers, enter to select operator intervention and 
then enter T to specify operating system deadstart from tape. Next, enter the 
tape channel, equipment, and unit numbers that describe where the deadstart tape 
is mounted. 

• For all other models, press the CR key. 

5. Enter CMRDECK entries. 

• An instructional display (CMRINST) appears that gives the format for CMRDECK 
entries. Do the following to page to the screen where you enter data: 

On the CC545 console, press the right blank key. 

On the CC634B console, press the tab key. 

• Enter any CMRDECK changes. When you have finished, enter: 

NEXT. 

6. Enter EQPDECK entries. ■ 

• An instructional display (EQPINST) appears that gives the format for EQPDECK 
entries. Do the following to page to the screen where you enter data: 

On the CC545 console, press the right blank key. 
On the CC634B console, press the tab key. 

• Make additional EQPDECK entries to describe your hardware configuration. Use 
the recommended CYBER channel configuration conventions. These channel 
conventions are listed in appendix G. 

• When you have finished making the EQPDECK entries, enter: 

GO. 

The system now begins loading. If you are requested to do so, enter the current date 
and time. When the system is loaded, the initial A and B displays appear. 
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STEP 2: INSTALL PERMANENT FILES 

The permanent files for your system are released on the permanent file tapes. You Install 
these files by using the SYSGEN command. (For a detailed explanation of SYSGEN and all 
SYSGEN options, refer to appendix B.) 

Before using SYSGEN to install permanent files, note the following: 

• SYSGEN User Names and Passwords 

The SYSGEN command uses certain user names and passwords to install the necessary 
permanent files. (User names and passwords are stored in a validation file.) If 
you do not have a validation file, SYSGEN creates a file with the validations 
necessary for installation. If you have a validation file, SYSGEN does not modify 
the file. If you want to use your own validation file, you must temporarily modify 
the file so that SYSGEN can find the user names and passwords it needs, or you can 
modify SYSGEN. Refer to appendix B for more information. 

• Permanent File Replacement 

If you have permanent files on your disk with the same names as the released 
permanent files, SYSGEN replaces these files with the released version. If you do 
not want these files replaced, make a backup copy of the files you want to save 
before using the SYSGEN command. Then, after using SYSGEN to install permanent 
files, replace the files on disk with your backup copies of the files. For a list 
of the permanent files that are automatically installed by SYSGEN, refer to appendix 
B. 

• Installation of Online Manuals 

The permanent file tapes contain both the source and bound files for each online 
manual. SYSGEN automatically installs all the bound online manual files and a 
procedure file called MANLOAD on user name MANUALS. The bound version of the online 
manuals is used by the EXPLAIN command. If you want to modify any of the online 
manuals, you can use the MANLOAD procedure to install the source version of the 
manuals. Also, because the online manuals use a great amount of disk space, you 
should delete any manuals you do not need once installation is completed. 

• Installation of Concurrent Maintenance Library (CML). 

The permanent file tapes contain the most recent version of CML at the time NOS 
released. It is automatically installed to user name CDCCE by X. SYSGEN (FULL). You 
should inform your customer engineer (CE) that the file is available. Also, because 
the file takes up a large amount of disk space, you should request that your CE 
remove any unnecessary diagnostics once installaion is complete. 

To install all permanent files, follow these steps: 

1. Enter the following command: 

X.SYSGEN(FULL) 

2. Mount the requested permanent file tape on an appropriate tape unit when you are 
prompted to do so. The volume serial number (VSN) for each tape is printed in the 
media number field of the external tape label. SYSGEN automatically assigns the 
tape. 

When this procedure is completed, all the necessary permanent files are set up on your 
default family device. 
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STEP 3: CREATE AND MOVE CONFIGURATION FILES 

There are four types of configuration files you might need to create: 

• A Logical Identifier Configuration File 

• A Network Configuration File and a Local Configuration File 

• A Remote Host Facility Configuration File 

| • A Mass Storage Archival Subsystem Configuration File 

Logical Identifier Configuration File 

If you ordered the NOS Scope Station, the Remote Host Facility (RHF), or the Permanent and 

Queued File Transfer Facility (PTF/QTF), you must create the Logical Identifier 

Configuration File (LIDCMid) to define the physical and logical machines available to your 

system. The system uses this file to automatically create a Logical Identifier Table (LDT) 

in central memory. Refer to the NOS 2 Analysis Handbook for information about creating an 

LIDCMid file. 

Network and Local Configuration Files 

If you installed NAM, you must create a Network Configuration File (NCF) and a Local 

I Configuration File (LCF). To do so, use the Network Definition Language (NDL). A sample 
network configuration file called NDLDATA is automatically installed by SYSGEN(FULL) on the 
user name INSTALL. 

SYSGEN automatically created a Communications Control Program (CCP) load file which is 
referenced by the NCF. Refer to the SRB for the list of Network Processing Unit (NPU) 
variants you received. If the released variants listed in the SRB are not acceptable, or if 
you want to add CCP online diagnostics or the 3270 Terminal Interface Program (TIP) to your 
variants, you must create your own variant from source code. 

| To help you build CCP and Cross, a partially built CCP is supplied on the permanent file 
tapes. Refer to section 5 for more information about CCP and Cross installation. 

Refer to section 5 and the NDL Reference Manual for more information about NCFs. 



Remote Host Facility Configuration File 

If you installed the RHF, you must create an RHF Configuration File (RCFMid). Refer to the 
NOS 2 Analysis Handbook for more information. 

Mass Storage Archival Subsystem Configuration File 

If you installed the Mass Storage Archival Subsystem (MAS), you must create a MAS 
configuration file. Refer to the NOS 2 Analysis Handbook for more information. 



' 2 ~ 6 60459320 E 



STEP 4: CREATE A NEW DEADSTART FILE 

To create a new deadstart tape that contains entries for your site, follow these steps: 

1. Get a copy of the deadstart decks (CMRDECK, EQPDECK, IPRDECK, LIBDECK, and APRDECK) 
you used in Step 1, Deadstart Using the Released Deadstart Tape. Use the following 
commands : 

X.DIS. 

COMMON(SYSTEM) - 

GTRCSYSTEM.LGOdeckname! ,deckname2, • • • ,deckname n | 

Replace deckname^ through deckname n with the names of the deadstart decks you 

want to update. (For example, CMRD03 for CMRDECK 03, EQPD03 for EQPDECK 03, and so 

forth). 

2. Use an available editor to make any necessary changes to the deadstart decks on file 
LGO. On 800 series computers, you can use the Remote Diagnostic Facility (RDF) as a 1 
means to using some NOS editors. Refer to appendix F. I 

3. When you have made all the necessary changes to the deadstart decks, use the 
following commands to merge the records on file I£0 with the contents of your 
current system: 

SYSGEN(DST,SYSTEM,LGO,NEW,0,dd) 
DROP. 

Replace dd with the tape density you want to use for the new deadstart tape (HY, HD, 
PE, GE). 

4. When you are prompted to mount a tape, mount an unlabeled scratch tape. Then enter 
this command: 

VSN.es t.NDT. 

Replace est with the Equipment Status Table (EST) ordinal number of the tape drive | 
unit where your scratch tape is mounted. 

When this procedure has finished executing, you have a new deadstart tape to use for 
subsequent deadstarts. 
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COMPONENT ORDER INSTALLATION 

This section describes how to install a component order using the binaries and source code 
released on the permanent file tapes. If you plan to customize your component order (build 
| the components from source code), you must execute these commands from your installation 
name to update the RECLAIM database. Then refer to sections 3 through 5 for information 
about customizing products. 

Before using the procedures detailed in this section, note the following: 

• To install a component order, you need the released permanent file tapes and your 
deadstart file from a previous full product order of the same PSR level. Your 
validation file must contain the user names and passwords listed in appendix B. You 
must also perform the component installation from the installation user name INSTALL 

I using this USER command: USER, INSTALL, INSTALL. 

• SYSGEN(UPGRADE) merges the binaries on the permanent file tapes with your existing 
system, automatically updates existing binaries and adds new ones, and optionally 
writes a new deadstart tape. After you execute the SYSGEN(UPGRADE) command, you can 
execute the SYSGEN(FILES.vsn) command to install the permanent files. However, if 
no permanent files need to be installed, the SYSGEN(FILES.vsn) command does nothing. 

There are three ways you can use the SYSGEN(UPGRADE) command: 

- Update the RECLAIM database without creating a deadstart tape. 

- Build a deadstart tape by requesting tapes. 

- Build a deadstart file using local files. 
These options are detailed on the following pages. 

UPDATING THE RECLAIM DATABASE 

If your component order consists of products which do not add binaries to the deadstart 
tape, or if you want to update the RECLAIM database without creating a new deadstart file, 
perform this step: 

• Enter this command: 

SYSGEN(UPGRADE,0,0,vsn,dd) 

Replace vsn with the VSN of the CDC-supplied permanent file tape. The VSN is listed 
in the media number field of the external tape label. 

Replace dd with the tape density of the permanent file dump tape (HY, HD, PE, GE). 
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CREATING A DEADSTART TAPE USING TAPES 

To create a new deadstart tape using a previous deadstart tape, follow these steps: 

1. Enter this command: 

SYSGEN (UPGRADE, OLD, NEW, vsn.dl ,d2) 

Replace vsn with the VSN of the CDC-supplied permanent file tape. The VSN is in the 
media number field of the tape label. 

Replace dl with the tape density of the permanent file tape (HY, HD, PE, or GE). 

Replace d2 with the tape density of the deadstart tape and the tape density for the 
new deadstart tape. 

2. Mount the current or old deadstart tape with a VSN of ODT (old deadstart tape) when 
you are prompted to do so (VSN, est, ODT). 

3. Mount an unlabeled tape for the new deadstart tape with a VSN of NDT (new deadstart 
tape) when you are prompted to do so (VSN, est , NDT). 

4. Load permanent files from the permanent file tape by entering the following command 
at the system console: 

X.SYSGEN(FILES ,vsn) 

Replace vsn with the VSN you used in step 1 . 

CREATING A NEW DEADSTART FILE USING LOCAL FILES 

This option merges the component-order binaries with your base deadstart file (specified by 
the old parameter) and produces a new deadstart file (specified by the new parameter). 

1. Enter this command: 

SYSGEN(UPGRADE,old,new,vsn,dd) 

Replace old with the file name of the deadstart file you have preassigned. 

Replace new with the file name you want for the new deadstart file. You can 
preassign this file as a magnetic tape file, direct access file, or a local file. A 
tape will not be requested for writing the new deadstart file. 

Replace vsn with the VSN of the CDC-supplied permanent file tape. The VSN is in the 
media number field of the external tape label. 

Replace dd with the tape density of the permanent file tape (HY, HD, PE, or GE). 

2. Load permanent files from the permanent file tapes by entering this command at the 
system console: 

X.SYSGEN(FILES,vsn) 

Replace vsn with the VSN you used in step 1. 
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PREPARING FOR A CUSTOMIZED INSTALLATION 



This chapter gives step-by-step instructions for preparing your system for a customized 
installation. Preparation consists of the following steps: 

Step 1: Setting up your permanent file environment. 

Step 2: Customizing installation procedures. 

Step 3: Creating USER files for input to installation procedures. 

Step 4: Creating files GLOBLIB and PRODUCT. 

Step 5: Executing the MODOPL procedure to modify NOS installation parameters. 

Before you begin preparing to install a customized system, note the following: 

• Because all products are prebuilt by CDC, you need only rebuild the products you 
want to customize, and products that are dependent on the products you are 
customizing. 

• Make a list of the products you want to customize. Next, check the product 
dependency chart in section 4 (figure 4-1) to find out if other products are 
dependent on the products you want to customize and add those to the list. These 
are the products you must rebuild. 

• Carefully review your plans for customizing the operating system and products. 
Refer to section 5 for special information about each product you are installing. 

• Special installation parameters, procedures, and commands are detailed in appendix 
B. 

• Special information about installing a 63-character set system is detailed in 
appendix E. Read this appendix before you begin installing your system. 

The following special information is for a customized component order installation: 

• If you are installing a customized component order, you must use a deadstart tape 
from a previous order of the same PSR level. 

• Before installing the customized component order, you must first use the 
SYSGEN (UPGRADE) command to update the RECLAIM database. Follow the steps in 
Component Order Installation in section 2 of this manual. 

• If your component order contains a Modify product that resides on the composite OPL, 
you must update your existing composite OPL before building the component order 
product. To do this, first run the SYSGEN (UPGRADE) command as described in section 
2. Then use the SYSGEN (RECLAIM) command to load file OPL630 from the component 
order permanent file tape. This file must be LIBEDITed against your previous 
composite OPL. (If you have updated the composite OPL with local code, be sure to 
use your OPL as a basis for the LIBEDIT). Once you have created the merged 
composite OPL, you can begin your customized installation of the component order. 
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STEP 1 : SETTING UP YOUR PERMANENT FILE ENVIRONMENT 

If you are installing on a dedicated system (that is, you have set aside time on your 
computer to be used only for installation), you can deadstart your system using the released 
deadstart tape and then use SYSGEN to load all the necessary permanent files. Follow the 
steps described in Dedicated System Environment Installation. 

If you are installing on a production system (that is, you will not be scheduling dedicated 
time for your installation), you must extract certain files from the release tapes. Follow 
the steps described in Production Environment Installation. 

You must decide where you want to store source files during the installation process. You 
can either let the installation decks load files automatically from the permanent file tapes 
or you can preload the files to disk. If you let the installation decks automatically load 
the required permanent files, you can make the files disk-resident or you can use local 
files during the installation procedures. Note that some source files must be 
disk-resident; for example, the composite OPL and numerous CCP build files. Once you have 
loaded the source installation tools, you can set up files for disk installation. Refer to 
appendix B for information about controlling the permanent file environment. 



DEDICATED SYSTEM ENVIRONMENT INSTALLATION 

If you are installing on a dedicated system, follow these steps to prepare your system for a 
customized installation: 

1. Deadstart your system using the deadstart tape. Then, create or modify your 
deadstart decks (CMRDECK, EQPDECK, IPRDECK, APRDECK, LIBDECK) as necessary. 

2. Modify your validation file so that you can use the SYSGEN command to load the 
necessary permanent files. Refer to SYSGEN validations in appendix B. (Note that 
SYSGEN(FHLL) creates validations for you if you have none.) 

3. • If you already have the permanent files necessary to run your system and only 

need to load the installation procedures, execute the following command from the 
system console: 

X. SYSGEN (SOURCE , CCP ) 

Include the keyword CCP only if you want to have CCP /CROSS binary files loaded. 

• If you want to have SYSGEN create all system permanent files in addition to 
loading installation tools, enter these commands: 

X.SYSGEN(FULL) 
X.SYSGEN(SOURCE,CCP) 

Include the keyword CCP only if you want to have CCP /CROSS binary install files 
loaded. 

Refer to section 5 for more information about the CCP binary installation. 
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PRODUCTION ENVIRONMENT INSTALLATION 

If you are installing on a production environment system, do the following to prepare for a 
customized installation: 

• Mount the released deadstart tape on an available tape unit and enter these commands: 

LABEL, TAPE ,VSN=vsn,D=density ,LB=KU ,F=I . 

COPYEI, TAPE, SYSTEM ,V. 

RE TURN, TAPE. 

GTR( SYSTEM ,SYSGEN)PROC/SYSGEN 

GTR( SYSTEM , PFG )ULIB/PFGLIB 

SYSGEN ( SOURCE , CCP ) 

Include the keyword CCP only if you want to load CCP/CROSS binary installation 
files. Refer to section 5 for more information. 

These commands load the RECLAIM database (RECLDB), DECKOPL, INSTALL, CODEPL, MISCPL, NOS PSR 
report file (PSRRPT), USERBPS, NAMSTRT (if appropriate), and COMMOD and make RECLAIM a 
permanent file. 

In addition to setting up RECLAIM and the RECLAIM database, these commands load numerous 
other files needed for a source installation. Refer to appendix B for a complete list of 
files. 
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STEP 2: CUSTOMIZING THE INSTALLATION PROCEDURES 

You build products by executing installation procedures on the INSTALL procedure file. To 
customize the installation procedures on the INSTALL file, follow these steps: 

I NOTE | 

If you want to install a 63-character set, 
read appendix E before continuing your 
installation. 



1. List the contents of DECKOPL by using the DECKLIS procedure (for details about 
DECKLIS, refer to appendix B): 

BEGIN ,DECKLIS , INSTALL . 

2. Edit file COMMOD using an available editor. File COMMOD is a correction set 
containing parameters which control the following: 

• A disk installation. 

• A disk installation using auxiliary packs. 

• A USERCHG file for installation procedures. 

• Different values for other common parameters. 

Refer to COMMOD File Parameters in appendix B for a list of the parameters you can 
change . 

3. Locate the parameters you want to change, and specify the values you want for the 
parameters. When you have finished, replace file COMMOD. 

4. Recreate the INSTALL file to include the new parameter values by entering this 
command : 

BEGIN , SETUP , INSTALL , M0D=COMM0D , INSTALL . 
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STEP 3: CREATING USER FILES 

To further customize products during installation, you can create USER files (files 
containing modified code for each product you want to customize). Each file can contain the 
following: 

• Programming Systems Report (PSR) corrective code. 

• MISCPL code. 

• Product installation parameter settings (for specific parameters for a product, 
refer to the product entry in section 5). 

• Site code. 

Refer to section 5 and the Software Release Bulletin (SRB) for special information about 
each product you are installing. 

When you create a USER file that contains modifications for a product, these modifications 
must be in the same format as the product you are modifying, either Modify or Update. NOS, 
NOS products, and APL 2 are in Modify format. All other products are in Update format. 



USERF PARAMETER 

When an installation job is executing, it expects to find your modifications on a local file 
named USER. However, if you do not want to make your modification file local to the 
installation job, you can use the USERF parameter on the installation procedure call to 
specify the permanent file that contains your modifications. For example, you can store 
local modifications for the product AAM2 on the permanent file USERAAM. Then, when you are 
calling the AAM2 installation procedure to build AAM2, you can use the USERF parameter on 
the procedure call to pass the file name of the modification file USERAAM. 

BEGIN ,AAM2 , INSTALL, USERF=USERAAM. 



NOTE 



If you use file USER to add site modifica- 
tions, the code is not installed on the 
program library. This code is applied last 
and Is added to the generated binaries. If 
you need this program library as input for 
another product installation, all the code 
is not present and problems could result. 
To avoid this, create a new program library 
containing your user code. 
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STEP 4: CREATING FILES GLOBLIB AND PRODUCT 

The SEED procedure creates three files: PRODUCT, DIRFILE, and GLOBLIB. The binaries in 
PRODUCT and GLOBLIB are used to satisfy all dependencies for the start of a full 
installation, as well as dependencies for a partial installation. DIRFILE is used to keep 
track of all the binaries in file PRODUCT. 

SEED places necessary user libraries on file PRODUCT and places the released binaries for 
| COMPASS, SYMPL, UPDATE, COPYL, ITEMIZE, LOADER, TDUEX, PASCAL, and procedures PDU and ULIB 

on file GLOBLIB. SEED also places the following text binaries on GLOBLIB: LDRTEXT, NETTEXT, 
| SMTEXT, NOSTEXT, PSSTEXT, SYSTEXT, CTITEXT, IOTEXT, SSYTEXT, PPTEXT, and CETEXT. To aid in 

the installation process, the binaries for the released versions of RECLAIM, NDLP, and 

SYSGEN are placed in file GLOBLIB. The installation jobs use these binaries instead of 

those in the running system. 

To execute the SEED procedure, you must have a copy of the released system. If you have 
deadstarted using the released deadstart tape, you can enter COMMON(SYSTEM). If not, issue 
a tape LABEL or REQUEST command for the released deadstart tape. 

Here is the format for the SEED call: 

BEGIN, SEED, INSTALL, paraml ,param2 

Parameter Description 

f I)ST=dstname Local file name for your copy of the system. If the file 

dstname is not a mass storage file, dstname is copied to a mass 
storage file before the GTR command in the SEED procedure 
extracts the required binaries. 

REBUILD The keyword parameter, REBUILD, causes SEED to load binaries 

into GLOBLIB and PRODUCT to satisfy all dependencies. You 
should specify REBUILD if you will not be starting your 
installation procedures with the first product on the dependency 
chart . 

RESET The keyword parameter RESET causes SEED to initialize the files 

JOBSTAT and DAYFILES; these files keep statistics on the 
installation procedure jobs and dayfiles. To get a report of 
the resource usage of your installation jobs and a list of what 
jobs have passed or failed, refer to REPORT Procedure in 
appendix B. 
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STEP 5: EXECUTING THE MODOPL PROCEDURE TO MODIFY NOS INSTALLATION 
PARAMETERS 

Use the MODOPL procedure to apply code (for example, Installation parameters) against the 
composite OPL. (The OPL contains all Modify-formatted products except APL and TDU.) 

If you are not applying any modifications to the composite OPL, you do not need to execute 
MODOPL. The OPL will be automatically loaded from tape when it is needed. If you execute 
MODOPL, it creates a disk file OPLpsrout (psrout defaults to the current release level; for 
example, OPL630). If DISKINS=NO, MODOPL also writes a copy to tape. 

MODOPL always writes the updated program library to a permanent file named OPLpsrout. The 
common deck COMSOPL defines its residency. OPLpsrout is used as an auxiliary PL by many 
installation jobs. The operating system installation jobs use it to generate the compile 
file for operating system installations. 

For execution of the MODOPL procedure, create file USER to include the following items: 

• Miscellaneous code (optional) from MISCPL. 

• Modifications of the NOS installation parameters (refer to section 5). 

• Modifications to operating system products (refer to section 5). 

• Site code. 

To execute the MODOPL procedure, enter this command: 
BEGIN .MODOPL , INS TALL . 
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THE CUSTOMIZED INSTALLATION PROCESS 



After you have prepared your system for a customized installation by following the steps in 
the preceding section, you are ready to begin the actual installation process, which 
consists of these four steps: 



Step 1: Building products from source code. 
Step 2: Moving permanent files to appropriate user names. 
Step 3: Creating a new deadstart tape. 
Step 4: Verifying your installation. 
These steps are detailed on the following pages. 
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STEP 1 : BUILDING PRODUCTS FROM SOURCE CODE 



RUNNING INSTALLATION PROCEDURES 

You build a product from source code by executing an installation procedure from file 
INSTALL. You can call the procedures interactively or you can submit them as batch jobs. 
If you call a procedure interactively, the procedure submits a batch job for execution 
(unless you have set IA=YES; refer to COMMOD file parameters in appendix B). If you require 
file USER for an interactively called procedure, you must specify the USERF=pfn parameter 
(refer to USERF Parameter in section 3) on the call to the procedure. Here is the format 
for calling an installation procedure: 

BEGIN, procname , pi , p2 , p3 , . . . , pn. 

Replace procname with the installation procedure name. These names are listed in tables 
4-1, 4-2, 4-3, 4-4, 4-5, and 4-6. The optional parameters (pi through pn) include two types 
of parameters: common and unique. Refer to COMMOD file parameters in appendix B for a list 
of common parameters; refer to section 5 for the unique parameters of a specific 
installation procedure. 

If you are installing a customized component order, refer to figure 4-1 and table 4-7. 
Figure 4-1 shows the product dependencies and table 4-7 lists the OIP products and the 
DECKOPL build procedures that you need for assembling each product. 



PRODUCT DEPENDENCIES 

Some installation procedures require the output of another installation procedure. These 
procedures are dependent on other procedures; that is, they cannot be run until the 
procedure they depend on is completed. Figure 4-1 illustrates the product installation 
procedure dependencies . 

Based on whether a procedure is dependent on another, the procedures have been separated 
into six groups. Run the procedures in the order described below. 



Run Group 1 

Run the group 1 procedures in the order in which they are listed in table 4-1 . Do not run a 
procedure until the preceding procedure has finished. 



Run Group 2 

Run the group 2 procedures listed in table 4-2 after running all the procedures in group 1. 
You can run them in any order you want. 
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Run Group 3 

Run the group 3 procedures listed in table 4-3 after all the procedures in group 1. Group 3 
procedures must be run in the order listed in table 4-3. 



Run Group 4 

Run the group 4 procedures listed in table 4-4 after all the procedures in group 1. Group 4 
procedures must be run in the order listed in table 4-4. 



Run Group 5 

Run the group 5 procedures listed in table 4-5 after all the procedures in group 1 and after 
the AAM2 procedure from group 3. Group 5 procedures must be run in the order listed in 
table 4-5. 



Run Group 6 

Run the N0S2B procedure after all the group 1 procedures, the FTN5 procedure from group 4, 
and the NAM5 procedure from group 5. 
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GROUP 1 



MODOPL 



CCG 



RHC 



BINEDIT 



BA8IC3 



FCL5 



SOBT5 



ALGOL5 



TEXT 



TEXTIO 



COMPASS 



UPDATE 



FCL1 



FTN4 



FTNTS 



SYMPL 



SORT 



OSUB 



OSTEXT 



LOADER 



FORMAT 



MDD 



MMF 



HSIO 



XEDIT 



NOS 



PASCAL 



BAM 



FCL2 



BITS 



CID 



F45 



PMD 



Figure 4-1. Build Dependencies Chart (Sheet 1 of 3) 
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MSS 



NSS 



GROUP 2 (Run after Group 1 in any order) 



CCL 



FSE 



PLI 



NIP5870 



LCS3 



FCS3 



MAS 



TDU 



APL2 



FORM 



TRACER 



GROUP 3 (Run after Group 1) 



AAM2 



DDL3 



FDBF 



CDCS2 



I 



IMF1 



COBOL5 



I 



QU3 



DCL 



Figure 4-1. Build Dependencies Chart (Sheet 2 of 3) 



60459320 E 



4-5 • 



- 












GROUP 4 (Run after Group 1) 
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AP1L 
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GROUP 5 (Run after Group 1 and AAM2 from Group 2) 
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ITF 




IAF 


MCS 




CCPPH1 




RHP 


RBF5 


TAF 
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RDFEX 
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CCPVAR 
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CCPLOAD 




GROUP 6 (Run 


i after FTN5 A 


ND NAM5) 








NOS2B 



































Figure 4-1. Build Dependencies Chart (Sheet 3 of 3) 
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Table 4-1. Group 1 Products 
(Sheet 1 of 2) 



Procedure Name 


Unique Keywords 


Required Files 


MODOPL 




OPLpsrin 


TEXT 


MFT=mft 
ECS=ecs 
CSET=cset 


TEXTpsrin 


TEXTIO 




TXIOpsrin 


COMPASS 




CPSlpsrin 


UPDATE 




UPDlpsrln 
CPSlpsrout 


OSTEXT 




OPLpsrout 


CCG 




CCGlpsrin 


RHC 




RHClpsrin 


BINEDIT 




BINEpsrln 
CPSlpsrout 


FCL1 




FClApsrin 
CPSlpsrout 


LOADER 


PRESET=value 

MAP=map 

FLMSG=flmsg 


LDRlpsrin 


FORMAT 




FMATpsrin 
OPLpsrout 


MDD 




MDDlpsrin 
OPLpsrout 


MMF 




OPLpsrout 


HSIO 




OPLpsrout 


XEDIT 




OPLpsrout 


NOS 




OPLpsrout 


FTN4 




FTN4psrin 
CPSlpsrout 
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Table 4-1. Group 1 Products 
(Sheet 2 of 2) 



Procedure Name 


Unique Keywords 


Required Files 


FTNTS 




FTl4psrin 
CPSlpsrout 


SYMPL 




SYMPpsrin 


PASCAL 




PASCpsrin 
OPLpsrout 


BASIC3 




BAS3psrin 

CPSlpsrout 

OPLpsrout 


BAM 




BAMlpsrin 
TEXTpsrout 


FCL5 




FCL5psrin 
CPSlpsrout 


SORT 




SRT4psrin 


S0RT5 




SRT5psrin 


ALG0L5 




AGL5psrin 


OSLIB 




OPLpsrout 
TLIBpsrin 


FCL2 




FCL4psrin 
CPSlpsrout 


BIT8 




BIT8psrin 


CID 




CIDlpsrin 
OPLpsrout 


PHD 




PMD5psrin 
CPSlpsrout 


F45 




F451psrin 
CPSlpsrout 
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Table 4-2. Group 2 Products 



Procedure Name 


Unique Keywords 


Required Files 


MSS 


SAVELIB 


OPLpsrout 


CCL 




CCLlpsrin 

CPSlpsrout 

OPLpsrout 


FSE 




OPLpsrout 


PLI 




PLIpsrin 

CCGlpsrout 

CPSlpsrout 


NIP5870 




OPLpsrout 


NSS 




NSSlpsrln 
OPLpsrout 


LCS3 




LCS3psrin 


FCS3 




FCS3psrin 


MAS 


SAVELIB 


OPLpsrout 


TDU 




TDUlpsrin 


APL2 


TERMTYP=termtyp 


APL2psrin 
OPLpsrout 


FORM 




FORMpsrin 


TRACER 




OPLpsrout 
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Table 4-3. Group 3 Products 



Procedure Name 


Unique Keywords 


Required Files 


AAM2 


SRT4 


AAM2psrin 


DDL3 




DDL3psrin 
CPSlpsrout 


FDBF 


FTN4 


FDBFpsrln 

CPSlpsrout 

DDL3psrout 


CDCS2 


DEBUG, SRT4 


CDCSpsrln 

AAM2psrout 

DDL3psrout 

OPLpsrout 

CPSlpsrout 


C0B0L5 


TAF, N0CDCS.SRT4 


C0B5psrin 


C0B0L5Q 


TAF, N0CDCS.SRT4 


C0B5psrin 


DCL 




DCL2psrin 


IMF1 


SRT4 


IMFlpsrin 

CPSlpsrout 

DDL3psrout 


QU3 


SRT4, IMF 


QU31psrin 

DDL3psrout 

OPLpsrout 



4-10 



60459320 E 



Table 4-4. Group 4 Products 



Procedure Name 


Unique Keywords 


Required Files 


FTN5 




FTN5psrin 

CPSlpsrout 

CCGlpsrout 


MSSI 


FTN4 

BLDMLIB 

MSAMLIB 


MSSIpsrin 
OPLpsrout 


AP1I 


FTN4 
MEMSIZE 


APlIpsrin 


MMCL 


FTN4 


MMCLpsrin 


AP1L 


FTN4 
MAPTYPE 


MMCLpsrin 


CEDIAG 




CEDGpsrin 
OPLpsrout 


TOOLS 




OPLpsrout 



60459320 E 



4-11 



Table 4-5. Group 5 Products 



Procedure Name 


Unique Keywords 


Required Files 


RHF 




RHFlpsrln 

RHClpsrout 

OPLpsrout 


ITF 


NOTRACE 


ITFlpsrin 

RHClpsrout 

OPLpsrout 


RHP 


SUBSYS=subsys 
TRACE, DEBUG 


RHPlpsrin 

RHClpsrout 

OPLpsrout 


NAM5 


NOTRACE 


NAM5psrin 
OPLpsrout 


NAM5D 




NAMSpsrin 
OPLpsrout 


IAF 




OPLpsrout 


RBF5 


NOTRACE 


RBF5psrin 

NAMSpsrout 

OPLpsrout 


RBF5D 




RBF5psrin 

NAMSpsrout 

OPLpsrout 


RDFEX 




OPLpsrout 


MCS 


TRACE 


MCSlpsrin 

NAM5psrout 

OPLpsrout 


TAF 


DEBUG, TASKLB 


OPLpsrout 


CROSS 


refer to section 5 


CRSSpsrin 


CCPPHl 


DIAG, REMT, BSTP, 
XTRAPLS 


CCPBpsrin 
CCPTpsrin 
CCPRpsrin 
CCPDpsrin 


CCPBLB 


XREF 




CCPVAR 


VN=vn 




CCPLOAD 


GN=gn 
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Table 4-6. Group 6 Products 



Procedure Name 


Unique Keywords 


Required Files 


N0S2B 




OPLpsrout 
NOSBpsrln 



Table 4-7. OIP Options and Associated Build Procedures 
(Sheet 1 of 3) 



Product Name 


Related Build Procedures 


ALGOL-60 5 


ALGOL5 


APL 2 


APL2 


BASIC 3 


BASIC3 


COBOL 5 


COBOL5, FCL1, FCL2 , PMD 


Communications Control 




Program (CCP) 3 


CCPPH1, CCPBLB, CCPVAR, CCPLOAD 


Conversion Aids Subsystem 3 


LCS3, FCS3 


CYBER Cross System 1 


CROSS 


CYBER Databae Control 




System 2 


CDCS2 


CYBER Interactive Debug 


CID 


Data Catalogue 2 Version 2.0 


DCL 


Data Description Language 


DDL3 


FORTRAN Database Facility 1 


FDBF 


FORTRAN Extended 4 


FTN4, FCL1, FCL2, PMD 


FORTRAN Extended 4 with 




Interactive Option 


FTNTS, FCL1, FCL2, PMD 


FORTRAN 5 


FTN5, FCL5, PMD, CCG 


FTN 4/5 Conversion Aid 1 


F45 


Full Screen Editor 


FSE 


High Speed I/O Package 


HSIO 
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Table 4-7. OIP Options and Associated Build Procedures 
(Sheet 2 of 3) 



Product Name 


Related Build Procedures 


Information Management Facility 1 


IMF1 


Interactive Facility 1 


IAF 


Interactive Transfer Facility 


ITF, RHC 


Link Interface Program under CCP 3 


(Part of CCP 3) 


Maintenance Package 


TOOLS, CEDIAG, FORMAT, SYMPL 


Mass Storage Extended 


MAS 


Mass Storage Subsystem 1 


MSS 


MCCL V3, 




MAP Macro Control Library 


MMCL 


Message Control System 1 


MCS 


MSSI V3, MAP III 


MSSI, API I, AP1L 


Multi-Mainframe Module 1 


MMF 


Network Access Method 1 


NAM5/NAM5D 


NOS Online Manuals 


No Build Procedure 


NOS 2 Package 


LOADER, COMPASS, BAM, BIT8, OSTEXT, 




UPDATE, FORM, AAM2, TEXT, TEXTIO, BINEDIT, 




CCL, MDD, RDFEX, OSLIB, NOS, N0S2B, 




NIP5870, TDU 


NOS Scope 2 Station 


NSS 


PASCAL 170 


PASCAL 


PL/I 1 


PLI, CCG 


Printer Support Utility 


No Build Procedure 


PTF/QTF File Transfer Facilities 


RHP, RHC 


Query/Update 3 


QU3 


Remote Batch Facility 1 


RBF5/RBF5D 


Remote Host Facility Access Method 


RHF, RHC 
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Table 4-7. OIP Options and Associated Build Procedures 
(Sheet 3 of 3) 



Product Name 


Related Build Procedures 


Sort /Merge 4 


SORT 


Sort /Merge 5 


S0RT5 


Tracer 1 


TRACER 


Transaction Facility 1 


TAF, COBOL** 


Xedit 3 


XEDIT 


3270 TIP for CCP 


(Part of CCP 3) 


tAll the necessary supporting object routines are not delivered in the TAF TRANLIB. 
You must run the C0B0L5 installation procedure to add various routines that contain 
the TAF interface to TRANLIB. Refer to section 5. 
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STEP 2: MOVING PERMANENT FILES TO THE APPROPRIATE USER NAMES 

Some of the files created during the installation must be put in the appropriate permanent 
file catalog, usually UN=SYSTEMX, LIBRARY", or NETOPS. SYSGEN(FULL) installs a CDC-released 
version of the permanent files automatically. The following installation procedures produce 
files that must be relocated: 



Procedure 



Username 



Files 



CCPLOAD 


NETOPS 


Gxxx (change name 


NAM5/NAM5D 


NETOPS 


NAMSTRT 




SYSTEMX 


NAM.NAMNOGO 


IAF 


SYSTEMX 


IAF.IAFTM.IAFTR 


MSS 


SYSTEMX 


MSS 


RDFEX 


SYSTEMX 


RDF 


TAF 


SYSTEMX 


TAF 




KB100DC 


TASKLIB 


XEDIT 


LIBRARY 


XEDITH 


APL2 


APL0.APL1 


Refer to section 5 


CDCS 


SYSTEMX 


CDC 


DCL 


LIBRARY 


Refer to section 5 


MCS 


SYSTEMX 


MCS 


NSS 


SYSTEMX 


SSF 


FSE 


SYSTEMX 


SMF 


MAS 


SYSTEMX 


MAS 




SUBFAMO 


MSASCON 



The files listed above are placed on the installation user name after the corresponding 
installation procedure has been executed. 

The files to be moved are described under the installation procedure name in section 5. 
Section 5 also gives general information about subsystem startup. 

To move the files, use the SYSGEN(MOVE) command. For information, refer to appendix B. 
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STEP 3: CREATING A NEW DEADSTART TAPE 

To create a new deadstart tape, enter this command: 

BEGIN (GENDST , INSTALL , SYSTEM=ods ,NEW=new,D=d ,LIST=lis t ) 

This command merges the binaries in file PRODUCT with the current system or another 
deadstart tape to produce a new deadstart file. Refer to appendix B for more information 
about GENDST. 

If you are building on a system with limited disk space, you should execute GENDST followed 
by RESETP to reduce the size of file PRODUCT. 



STEP 4: VERIFYING YOUR INSTALLATION 

Verify the installation of products as follows. 

• Execute the REPORT procedure to get statistics on all completed installation 
procedures. 

• Execute a verification procedure to determine if the installed product is 
operational. 

The REPORT procedure can be executed after any installation job is completed. Refer to 
appendix B for information about the REPORT procedure. 

The verification procedures cannot be executed until you have completed the installation and 
have deadstarted the system using your new deadstart tape. 



VERIFICATION PROCEDURE 

Check the installation of the products with the verification procedures (refer to table 
4-8). A verification procedure can be run after the corresponding product is installed in 
the running system. That is, rebuild the product, create a new deadstart tape, deadstart 
with the new system, and then run verification jobs. Note that not all products have 
verification procedures. Also, NAM, CCP, and RHF verifications are more complex than other 
product verifications. For information on NAM, CCP, and RHF verifications, refer to Verify 
NAM and CCP and Verify RHF in this section. 

To verify that a product is successfully installed, run a job that contains this command: 

BEGIN , pname , INSTALL ,PRID=id. 

Parameter Description 

pname pname is the verification procedure name of the product to be 
verified (refer to table 4-8). 

PRID=id id is to 60. This parameter specifies the printer for 
verification job output. 
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I The following command calls all verification procedures on file INSTALL (refer to table 4-8) 
except VCDCS2A, VCDCS2B, VMCS1A, VMCS1B, VRHF, and VMSSI (refer to the descriptions of the 
CDCS2 and MCS procedures in section 5). 

BEGIN , VJOBS , INSTALL , PRID=printerid , PACE=n. 

The parameter printerid can be specified to select any printer you require (the default 
is 0). 

The parameter PACE is useful in delaying job submission in case your system has a limit on 
the number of jobs in the system. The default for PACE is 15. Four jobs are submitted, 
then VJOBS does a ROLLOUT, 15. before continuing. 

Some verification procedures request you to mount tapes. If DISKINS=YES, the proper disk 
file is automatically used. 

Since VJOB submits all verification procedures, procedures that verify unordered products 
fail. 
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Table 4-8. Verification Procedures 



Verification 


Required 




Verification 


Required 




Procedure Name 


Files 


Comments 


Procedure Name 


Files 


Comments 


VAAM2 






VIMF1 






VALG0L5 






VJOBS 




Submits all verifi- ■ 
cation jobs except 


VAPL2 










VCDCS2A, VCDCS2B, 
VMCS1A, VRHF, VMSSI, 
and VMCS1B. 


VBAM 






VLCS3 


LCS3psrout 




VBASIC3 






VMCS1A 




MCS must be enabled 


VBIT8 










execute VMCS1A (refer 
to section 5). 


VCDCS2A 






VMCS1B 




MCS must be enabled 


VCDCS2B 










to execute VMCS1B 
(refer to section 5). 


VCID 






VMSSI 




Contains an 


VC0B0L5 










FTN4=YES/N0 param- 
eter. The default 


VCROSS 


CRSSpsrout 








is FTN4=N0. Refer 
to section 5. 


VDDL3 






VPASCAL 






VFCS3 


FCS3psrout 




VRHF 
VPLI 






VFDBF 






VQU3 




VQU3 must be run as a 


VFOKM 










batch job. 


VFTN 






VSORT 






VFTNTS 






VS0RT5 






VFTN5 






VSTJMPL 






VF45 
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VERIFYING NAM AND CCP 

Use the following procedure to verify correct installation of NAM and CCP. 

| 1. Master clear all local and remote network processing units (NPUs). Refer to the NOS 
2 Analysis Handbook. 

| 2. Initiate NAM at control point n by entering the following DSD commands at the system 
console. 

SUBSYST. 

L. ENABLE, NAM, n. 

NAMNOGO. 

CFO.NAM.GO. 

Refer to the NOS 2 Analysis Handbook for more information on the NAMNOGO and the CFO 
commands. 

If IAF is to be brought up, you must not initiate NAM at control point 1 (n must be 
2 or greater). 

When NAM actually starts execution (that is, after NAMI has completed execution), 
NAM sends its version number to the system dayfile. The message has the following 
format. 

NAM VER ver - lvl 

ver Version number. 

lvl Programming Systems Report (PSR) summary level. 

When the network supervisor (NS) starts execution, it places in NAM's dayfile its 
version number and the date and time that both the network configuration file (NCF) 
and the network load file (NLF) were built. These messages have the following 
format. 

NS/ time VER ver - lvl. 

NS/ time NCF build date, build time. 

NS/ time title. 

NS/ time NLF build date, build time. 

time Time at which the message was sent to the dayfile. 

ver Product version number and lvl is the PSR summary level. 

title Site-supplied string to the Network Definition Language Processor 
(NDLP) for the NCF. 

NS proceeds to load all accessible NPUs. NS issues load status messages to the NAM 
K display (if the NAM K display is assigned to NS) and to the NAM dayfile (refer to 
the NOS 2 Analysis Handbook). 
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After the communications supervisor (CS) begins execution, it issues messages to the 
NAM dayf ile having the following format. 

CS/ time VER ver - lvl. 

CS/ time NCF build date, build time. 

CS/ time title. 

time Time at which the message was sent to the dayf ile. 

ver Product version number. 

lvl PSR summary level. 

title Site-supplied string to NDLP for the NCF. 

As each NPO is loaded, CS issues messages to the NAM K display (if the NAM K display 
is assigned to CS) and to the NAM dayfile having the following format. 

NP/npuname time NPU: npuname, AC npuid 

NP/npuname time SUPERVISION GAINED 

NP/npuname time CCP VERSION: ver, LEVEL: h, VARIANT: v 

time Time at which the message was sent to the dayfile. 

npuname Name of the NPU. 

npuid Node number of the NPU. 

ver CCP version number. 

h Hexadecimal number indicating the level of code in this version 

of CCP (adjusted by Control Data; not an installation 
parameter). 

v Hexadecimal number identifying the CCP variant. 

When the network validation facility (NVF) starts execution, it sends its version 
number and the local configuration file (LCF) build date and time to the NAM 
dayfile. These messages have the following format. 

NV/ time VER ver - lvl. 

NV/ time LCF build date, build time. 

NV/ time title. 

time Time at which the message was sent to the dayfile. 

ver Product version number. 

lvl PSR summary level. 

title Site-supplied string to NDLP for the LCF. 
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After NS successfully loads an NFU, CS issues a message to the NAM K display and the 
NAM dayfile for every logical link defined as active in the network configuration 
file. The message format follows. 

LLINK: linkname,EN,RL=3,H-N,npunamel/nid,npuname2/nid. 

Parameter Description 

linkname Name assigned to link in the network configuration file. 

npunamel Name of NFU that is connected to the coupler or trunk. 

npuname2 Name of NPU at the other end of the logical link. 

nid End node number of logical link (either coupler or NPU node 

number ) . 



NOTE | 



The remainder of this procedure determines 
that the network is running and able to 
process applications. Terminal Verification 
Facility (TVF) is used in this procedure. 
Use of TVF is described in the NAM1/CCP3 
Terminal Interfaces Reference Manual. 



3. Assign the K display to NAM by typing the following commands at the system console. 

K.NAM. 
K.ST. 

The NAM status display should appear on the screen. Refer to the NOS 2 Analysis 
Handbook for an explanation of the format. 

All applications connected to NAM should appear in the applications section (the 
column titled APP) of the status display. All front-end NPUs that are logically on 
in the equipment status table (EST) should appear in the EST section of the 
display. All enabled/active logical links should appear in the logical link section 
of the display. 

4. Log in from any network-supported terminal, specifying TVF as the application. The 
user name under which the login is performed must have permission to access TVF. 
TVF responds with several lines of information about the terminal followed by a 
prompt for input ( . . ) . 

5. Enter 2 followed by the message transmission key for the terminal class in use 
(carriage return for most asynchronous terminals). This initiates the TVF line 
test. TVF responds as follows. 

LINE TEST BEGINS 
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6. Enter any character followed by the message transmission key. If your page width is 
greater than 0, TVF responds by printing a single line composed of the character you 
entered followed by: 

TVF TEST COMPLETE 

• • 

7. Enter END to exit TVF. The system responds by issuing a message indicating the time 
of connection to TVF followed by a prompt for application selection. 

TVF CONNECT TIME hh.mm.ss 
termname -APPLICATION: 

8. Enter BYE to exit the network and log off. The system responds as follows. 

LOGGED OUT. 



RHF INSTALLATION VERIFICATION 

The VRHF procedure on DECKOPL can be used to verify the correct installation of Remote Host 
Facility (RHF) and permanent and queue file transfer applications. Before executing the 
procedure, ensure that the logical identifier table (LID) table is set up correctly. 

• Enter NC in your EQPDECK for the network access device (NAD). 

• Bring up the LID display by entering the LIDOU command. 

• Ensure that the physical identifier (PID) (M plus the 2-character machine 
identifier) matches the PID used on the BEGIN command entered under DIS. 

• Ensure that the LIDs LBK and LB2 are loopback LIDs under the host PID. 

Under DIS, execute VRHF with the following command, using the correct physical ID and NAD 
parameters for the mainframe where the test is to execute. 

BEGIN , VRHF , INSTALL ,PID=Mid , NADADDR=adr , CHANNEL=ch. 



Parameter 


Significance 


id 


Machine identifier. 


adr 


NAD address. 


ch 


NAD channel. 



Success of the verification is indicated by the message VERIFY GOOD in the output listing of 
the RHFVJOB job. 
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SPECIAL PRODUCT INSTALLATION INFORMATION 



This section gives special information for the customized installation of NOS and its 
products. The products are listed in alphabetical order according to their installation 
procedure name. If special information about a product does not exist, the product 
installation procedure is not listed. Here is a list of the installation procedures 
discussed in this section: 

AAM2 

APL2 

BAH 

BASIC3 

CCL 

CCP/CROSS (CROSS, CCPPH1 , CCPBLB, CCPVAR, CCPEDIT, CCPLOAD, CCPPURG) 

CDCS2 

CID 

COB0L5 and C0B0L5Q 

DCL 

FDBF 

FSE 

FTN4, FTNTS, and FTN5 

IAF 

IMF1 

ITF 

LCS3 and FCS3 

LOADER 

MAS 

MCS 

MSS 

MSSI, MMCL, API I, AP1L 

NAM5 

NOS 

N0S2B 

NSS 

QU3 

RBF5, RBF5D 

RHF 

RHP 

SORT 

TAF 

TDO 

TEXT and TEXTIO 

UPDATE 

XEDIT 

To get listings of the installation procedures, refer to the DECKLIS procedure in appendix B. 

The installation of controlware differs from product installation procedures; controlware 
installation is described in appendix D. 
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I SUBSYSTEM INITIATION 



SUBSYSTEM STARTUP FILES 

When you install a subsystem, you must ensure that there is a startup procedure file for 
initiating the subsystem. (Table 5-1 lists all the subsystems.) Startup files must be 
stored as indirect access files on user name SYSTEMX. They must also be named using the 
following format: 

subxxxx 

sub The 3-character name for the subsystem (for example, CDC). 

xxxx An optional 0- to 4-character extension to the name (for example, CDCS2). 

DECKOPL installation procedures create startup procedures for all subsystems and place them 
as indirect access files on the installation user name INSTALL. The files are named with 
the appropriate 3-character subsystem name. SYSGEN(FULL) places the released versions of 
all subsystem startup procedures on the system user name SYSTEMX. If you modify the 
procedures, you can use the SYSGEN(MOVE) procedures to move the files. Refer to appendix B 
for more information about SYSGEN(MOVE). 



SUBSYSTEM ENABLE AND DISABLE COMMANDS 

In addition to the procedure file creation and placement, you must issue ENABLE commands to 
tell the system which control point the subsystem is to operate as well as what system 
functions are required. You can enter the ENABLE (or DISABLE) commands at the system 
console or you can add them to the IPRDECK. Table 5-1 lists the necessary ENABLE and 
DISABLE commands. 



AUTOMATIC SUBSYSTEM INITIATION 

If you want a subsystem to be automatically initiated when you enter the DSD AUTO or 
MAINTENANCE commands, you should do the following: 

• Ensure that the startup procedure file has the 3-character name of the subsystem and 
is stored as an indirect access file on user name SYSTEMX. 

• Enable the subsystem and any other system functions by adding the appropriate ENABLE 
entries to the IPRDECK. 
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Table 5-1 summarizes the subsystem procedure names and the appropriate ENABLE commands 
necessary for Initiating the subsystem. 



Table 5-1. Subsystem Initiation 
(Sheet 1 of 2) 



Installation 
Procedure 


Subsystem 


Procedure 
Name 


ENABLE Commands 


CDCS2 


CDC 


CDC 


ENABLE, SCP. 
ENABLE, CDC, n. 


FSE 


SMF 


SMF 


ENABLE, SCP. 
ENABLE, SMF, n. 


IAF 


IAF 


IAF.IAFTM.IAFTR 


ENABLE, SCP. 
ENABLE, IAF. 


MCS 


MCS 


MCS 


ENABLE, SCP. 
ENABLE, MCS.n. 


MAS 


MAS 


MAS 


ENABLE, SCP. 
ENABLE, MAS, n. 
ENABLE, MASTER MAS. 
ENABLE, FILE STAGING. 


MSS 


MSS 


MSS 


ENABLE, SCP. 
ENABLE .MASTER MSS. 
ENABLE, FILE STAGING. 
ENABLE, MSS, n. 


MS SI 


MAP 


MAPCMI, MAPECS, 
MAPCH 


ENABLE, SCP. 

ENABLE, USER EXTENDED MEMORY. 

ENABLE, MAP, n. 


NAM5/NAM5D 


NAM 


NAM.NAMNOGO 


ENABLE, SCP. 

ENABLE, NAM, n. 


NSS 


SSF 


SFF 


ENABLE, SCP. 
ENABLE, SSF, n. 


NOS 


MAG 


MAG 


ENABLE, MAG. 


RBF5/RBF5D 


RBF 


No procedure, 
initiated by NAMI 


RBF initiation is controlled 
by NAMI 
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Table 5-1. Subsystem Initiation 
(Sheet 2 of 2) 



Installation 
Procedure 


Subsystem 


Procedure 

Name 


ENABLE Commands 


RDF 


RDF 


RDF 


ENABLE, RDF. 


RHF 


RHF 


No procedure 


ENABLE, SCP. 
ENABLE, RHF, n. 


TAF 


TAF 


TAFPRC 


ENABLE, SCP. 
ENABLE, SUBCP. 
ENABLE, TAF, n. 


NOTES: 


• RDF and MAG are always added to the deadstart file for system maintenance purposes. 
All other procedures are placed only on permanent files. 


• MAS, MSS, and RDF may require additional IPRDECK entries. 


• For more information about the IPRDECK, ENABLE and DISABLE commands, and subsystem 
startup, refer to the NOS 2 Analysis Handbook. 


• Enable either IAF or RDF, not both. 


• If you do not want to store the startup procedure files on user name SYSTEMX, you 
can put the procedure files on the deadstart tape and add *PROC directives to your 
LIBBECK. For more information, refer to the NOS 2 Analysis Handbook. 



5-4 



60459320 E 



AAM2 - CYBER RECORD MANAGER ADVANCED ACCESS METHODS VERSION 2 

This subsection describes these installation options for AAM2: 

• Unique Parameters 

• USER File Directives 

• Additional Procedures 



UNIQUE PARAMETERS 

SRT4 To assemble code to interface with Sort/Merge 4 rather than Sort/Merge 5, 
specify the keyword SRT4 on the call to AAM2. 



USER FILE DIRECTIVES 

If you want to gather additional file statistics, include the Update directive *DEFINE STATS 
in file USER. (Without this directive, the system gathers only normal file statistics.) 



ADDITIONAL PROCEDURES 

AAM2 includes one system compression/decompression routine. You can add up to 53 additional 
compression/decompression routines as system routines. Encapsulate each added routine and 
modify the capsule OPNM$AA. 

Each routine must have an entry point of the form CMPR$nn (nn is two decimal digits within 

the range 11 through 63). The first added routine's entry point name must be CMPR$11, the 
second routine's entry point name must be CMPR$12, and so forth. The entry point must be 
the second word (word 1) of the routine. 

The first three words of each routine must have the format shown in table 5-2. 



Table 5-2. Format of First Three Words of Compression/Decompression Routines 



Word 



Bits 



59 through 18 

17 through 
59 through 18 
17 through 
59 through 18 
17 through 



Contents 



Entry point name, 6-bit display code, 
left- justified, zero fill. 

1. 

0. 

Starting address of compression code. 

0. 

Starting address of decompression code. 
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An example of the construction of a single site-added compression/decompression routine 
follows: 

IDENT 

ENTRY CMPR$11 

VFD 42/0LCMPR$ll,18/l 

CMPR$11 VFD 42/0,18/COMPRES 

VFD 42/0,18/EXPAND 



COHERES BSSZ 



EXPAND 



EQ 



BSSZ 



EQ 
END 



COMPRES 



EXPAND 



The CYBER Loader requires standard relocation for fast dynamic loading of capsules; 
therefore, construct the VFD statements as shown in the preceding example. A return jump to 
the address specified in word 1 or 2 of the routine affects the execution of the compression 
or decompression code. 

For each added routine, add an entry to the capsule name table in deck OPNMDAA. The macro 
GENTBL (also part of OPNMDAA) generates the table entry and has the following format. 

GENTBL name 

Parameter Description 

name Entry point name specified in word of added routine. 

Specify table entries in consecutive, ascending numerical order. For example, to add three 
routines, make the following change to OPNMDAA. 

*B OPNMDAA. 32 9 

GENTBL CMPR$11 

GENTBL CMPR$12 

GENTBL CMPR$13 
*C 0PNMDAA,DIC0DAA,CWE0R1,0PENDAA 
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To add one additional compression/decompression routine, execute a job similar to the 
following. Either it must be a system origin job, or you must have system origin privileges 
and have DEBUG on. 

J° p Comments 

job command. 

USER , INSTALL , INSTALL . 

BEGIN , PRDIN , INSTALL , PRDNAME=AAM2 ,DISK=0 . 

UPDATE, K. 

RFL, 65000. 

COMPASS,A,I,S=TXTCRM,S=IPTEXT. Assembles OPNMDAA and DICODAA. 

SYMPL,ET=T,I,S=TXTCRM,S=IPTEXT. Compiles OPNMDAA. 

COMPASS, A. Assembles routine being added. 

RETURN, COMPILE. 

GROUP, $AAM$$CTL$. Encapsulates the modified capsule 0PNM$$AA 

CAPSULE, $0PNM$$AA$. (deck OPNMDAA) and the new compression 

CAPSULE, $CMPR$S11$. capsule. 

LDSET,OMIT=$SETUP.$/$RM$$SYS=$. 

L0AD.LG0. 

NOGO.NEWCAP. 

COMMON, SYSTEM. User must be validated to access common files. 

GTR , SYSTEM , OLD . ULIB/AAMLIB 

LIBEDIT,B=0. 

LIBGEN,F=NEW, P=AAMLIB . 

SYSEDIT. 

— eor — 

*IDENT 

Update directives to modify OPNMDAA. 
*C OPNMDAA, DICODAA, CWE0R1 .OPENDAA 
— eor — 

Compression/decompression routine 

being added (COMPASS). 
— eor — 

*DELETE CAP/OPNM$AA 
*FILE NEWCAP 
*BEF0RE *,CAP/* 
— eor — 
*FILE AAMLIB 
— eoi — 
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APL2 - APL VERSION 2 

The installation of APL2 consists of building APL2 and then installing APL2 permanent 
files. This subsection describes these installation options for APL2: 

• Unique Parameters 

• APL Entry Message 

• SYSGEN Functions 

• APL Validation Requirements 



UNIQUE PARAMETERS 

TERMTYP=ttype You can specify TEBMTYP=ttype on the call to the APL2 installation 
procedure, ttype defines the default terminal type. Refer to your 
listing of DECKOPL for allowable parameter values. The default for 
ttype is APLAS. 



APL ENTRY MESSAGE 

If you want to provide an APL entry message (a one- line message displayed when a user 
activates APL with a command), create a file named MESSAGE and make it local just prior to 
the BEGIN , APL 2, INSTALL. .. command. The file must contain only a one-line message which 
cannot exceed 80 characters. 



SYSGEN FUNCTIONS 

Only the APL loader can be captured on a deadstart tape. Except for the loader, APL2 runs 
from a set of permanent files. 

SYSGEN (FULL) installs all APL files on user names APLO and APLl. If you customize the APL 
files, install the modified files by performing these steps: 

1. Before running the APL2 build procedure, execute these commands from your 
installation user name: 

PURGE(PFGAPL2) 
DEFINE (PFGAPL2 /CT=S ) 
RETURN (PFGAPL 2) 

2. Run the APL2 procedure. Then enter these commands at the system console: 

X.DIS. 

USER ( INSTALL , INSTALL ) 
ATTACH (PFGAPL2) 
SYSGEN (APL2) 

Once the SYSGEN (APL2) command is completed, the user names APLO and APLl will have the 
updated APL permanent files. 
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APL VALIDATION REQUIREMENTS 

User names APLO and APL1 are required for running APL. If you have no validation file, 
SYSGEN will automatically create the user names and assign default passwords. If you have a 
validation file, you must create user names APLO and APL1 with the limits shown in table 5-3. 

If you want to change the default passwords for the two user names (APLO and APL1), use the 
MODVAL command. Refer to the Administration Handbook for information about using MODVAL and 
about changing validation files. If you want to use SYSGEN to reload files on these user 
names, you must temporarily set the passwords to the default values or you must update 
SYSGEN. 



Table 5-3. Recommended Limits for APLO and APL1 



Resource or 


User APLO 


User APL1 










Capability 


Keyboard 


Converted 


Keyboard 


Converted 


Mnemonic 


Entry 


Value 


Entry 


Value 


MT 


3 


3 


3 


3 


RP 


2 


2 


2 


2 


TL 


77B 


Unlimited 


77B 


Unlimited 


CM 


40B 


2037B 


40B 


2037B 


D8 


SB 


10 


5B 


10 


FC 


7B 


Unlimited 


7B 


Unlimited 


CS 


4B 


4096 


4B 


4096 


FS 


6B 


192 


6B 


192 


PA 


EVEN 


Even 


EVEN 


Even 


RO 


37B 


System 


37B 


System 


PX 


HALF 


Half 


HALF 


Half 


TT 


TTY 


TTY 


TTY 


TTY 


TC 


NORMAL 


Normal 


NORMAL 


Normal 


IS 


NULL 


Null 


NULL 


Null 


MS 


6B 


25088 


6B 


25088 


DF 


73B 


1008 


73B 


1008 


CC 


77B 


Unlimited 


77B 


Unlimited 


CP 


77B 


Unlimited 


77B 


Unlimited 


LP 


77B 


Unlimited 


77B 


Unlimited 


PT 


77B 


Unlimited 


77B 


Unlimited 


EC 


OB 


0B 


0B 


0B 


SL 


77B 


Unlimited 


77B 


Unlimited 


CN 










PN 










DS 


3B 


1536 


2B 


1024 


SC 










DT 










SP 










UP 










PW 


APLO 


APLO 


APL1 


APL1 


AW 


t 


tt 


t 


tt 


t Entry is 


CASF, CAND, CSRP, CPWC, CLPF, CSPF, 


CCNR. 




tt Value is 


000000000000000007 55 . 
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BAM - CYBER RECORD MANAGER BASIC ACCESS METHODS VERSION 1 

The following Installation parameters for BAM are defined in the Update common decks 
/CMNTXT/ and /TXTCRM/. Assemble deck TXTCRM to obtain a listing of the common decks. 



Parameter 



#LBLIM# 



#CMU# 
#NOCMU# 



Default 



10D 



Significance 

Number of words in tape label buffer. Because each user label 
requires 9 words, set LBLIM to 9m+l; m is the maximum number 
of file header (HDRn) labels allowed. Minimum value is 10 
words. 

Specifies use of compare and move unit (CMU) instructions in 
routine M0VE$RM. To remove the CMU code, delete the 
definition of CMU. To remove the no CMU code, delete the 
definition of NOCMU. If CMU and NOCMU are both defined, CYBER 
Record Manager determines at run time which MOVE routine to 
use by checking the CMU flag in RA.CMU. 

The use of CMU instructions reduces the execution time of a 
program using CYBER Record Manager for records of over 40 
characters. The use of CMU instructions in programs to be 
executed on models 835, 840, 845, 850, 855, or 860 is not 
recommended. 
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BASIC3 - BASIC VERSION 3 

The following installation parameter for BASIC3 is defined in deck BASCOMP. Assemble this 
deck to obtain the Update sequence number required to change the released value. 

Parameter Default Significance 

BDFLT 1.0 Array base; can be any nonnegative value expressed as a real 

value . 

The following parameters are defined in common deck LIPARAM. Assemble deck BASCARD to 
obtain a listing of LIPARAM. 

Parameter Default Significance 

MESSAG 1 Flag indicating whether BASIC issues time and memory use 

dayfile messages. A value of inhibits issuing of messages; 
a value of 1 enables issuing of messages. 

IP -AS Flag indicating default character set mode. A value of 

indicates normal (non-ASCII) mode (user must specify AS on the 
BASIC statement to override the default); a value of 1 
indicates ASCII mode (user must specify AS=0 on the BASIC 
statement to override the default) . 

IP.BL Flag indicating burstable listing. A value of indicates 

nonburstable listing (user must specify BL on BASIC statement 
to override the default); a value of 1 indicates burstable 
listing (user must specify BL=0 on the BASIC statement to 
override the default). 
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CCL - CYBER CONTROL LANGUAGE VERSION 1 

This subsection describes these installation options for CCL: 

• Installation Parameters 

• Additional Procedures 



INSTALLATION PARAMETERS 

The following installation 
procedures use the default 



Parameter 
IP .FPC 

IP.SCS 

IP.LCS 

IP.PNL 
IP.FP 

IP.DPF 



IP.DPFN 
IP.TAPO 



Default 



10 



40 

10 

50 
50 



PROCFIL 

1 



parameters are located on deck CCL. Because installation 
values, changing the values is not recommended. 

Significance 

Maximum number of characters in a keyword for a procedure call 
or procedure header directive. Maximum value is 10. 

Maximum number of characters for default and actual values. 
Maximum value is 80. 

Maximum number of characters in a label string. Maximum value 
is 10. 

Procedure nesting limit. Maximum value is 1023. 

Maximum number of keywords in a procedure call or procedure 
header directive. Maximum value is 500. 

Flag indicating logical existence of default procedure file 
name . 



Value 



Definition 



No default procedure file name. 

1 Procedure file name defaults to value of IP.DPFN. 
Default procedure file name. 

Flag indicating whether a procedure can reside on tape. 
Value Definition 







Procedure file cannot reside on tape. BEGIN hangs in 
RECALL if execution from tape is attempted. A value 
of decreases the execution size of CCL by 700s 
words for BEGIN, REVERT, WHILE, and ENDW. 

Procedure file can reside on tape. 
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Parameter 



Default 



Significance 



IP. EXP 



IP .ATT 



100 



Number of operands and operators allowed in a CCL expression. 
For each unit that this parameter is decreased from 100, the 
execution size of CCL is reduced by 2 words. 

Flag indicating whether the system searches the user name's 
permanent file catalog, if the requested procedure file is not 
local . 



IP.NPV 



IP.RLD 



Value Definition 

Permanent file catalog not searched. 

1 Permanent file catalog searched. In order to attach 
the requested procedure file, the system searches the 
indirect access files first and then the direct access 
files. 

Value used in the calculation of the size of the pattern value 
table (PVT). The PVT stores the checklist entries for each 
parameter in the procedure headers. The following formula 
determines the size of the PVT in words. 

PVT = IP.NPV x IP.FP x 2 

Flag indicating whether the system does a sequential or random 
search of a library to find the requested procedure. A random 
search is usually faster than a sequential search. 



Value 



Definition 



IP.SCL 



150 



Search library sequentially. 

1 Search library randomly by using the library directory. 

Maximum length in characters of lines in a procedure. Any 
restrictions as to the length of a command remain in effect, 
but a comment following the command terminator may extend to 
the length specified by IP.SCL. 



ADDITIONAL PROCEDURES 

CCL consists of three absolute overlays with entry point names and verb table entries for 
each CCL verb (command). Here are the CCL verbs and overlays: 



Overlay 
CCLBRWE 
CCLIFES 
CCLDS 



Verbs 
BEGIN, REVERT, WHILE, ENDW 
IF, IFE, ELSE, ENDIF, SKIP 
DISPLAY, SET 



If a CCL verb must be changed because of a conflict with an existing program on the 

dead start file, change both the entry point name and the verb table entry in the CCL overlay 

CCLBRWE. ' 
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CCP - CYBER CROSS SYSTEM AND COMMUNICATIONS CONTROL PROGRAM 

This subsection describes the following: 
Hardware Requirements 
Build Steps Description 
Binary Installation Option 
General Build Step Call 
Cross-Cross System Installation 
CCPPH1 Build Step 
CCPBLB Build Step 
CCPVAR Build Step 
CCPEDIT Build Step 
CCPLOAD Build Step 
CCPPURG Build Step 
CCP /CROSS Permanent Files 
CCP System Definition 
CCP Variant Load Module Definition 
CCP /CROSS Installation Examples 
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HARDWARE REQUIREMENTS 

A field length of llOOOOg Is required to build CCP. The following equipment configuration 
is the minimum required to execute CCP: 

• One 2550-2, 2551-1, 2551-3, or 2551-4 Host Communication Processor, consisting of at 
least the following items: 

- One multiplexer loop interface adapter. 

- One loop multiplexer. 

- One cyclic encoder board. 

- One CYBER communications coupler. 

- One memory unit. 

- One 8K micromemory board. 

• One communications line adapter (CLA), either a 2560-1 synchronous CLA or a 2561 
asynchronous CLA. 

• Total 2550 memory of at least 65K. 

Assign the CLA slots in the loop multiplexer in order of decreasing line transmission 
speeds. For example: 



Speed 

9600-bit per second (bps) line 
9600-bps line 
2400-bps line 
300-bps line 
150-bps line 



Slot Assignment 

Slot 1 (leftmost slot) 
Slot 2 
Slot 3 
Slot 4 
Slot 5 
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BUILD STEPS DESCRIPTION 

The CCP/Cross installation procedures consist of seven sequential build steps. The 
following build step descriptions are listed in their proper execution sequence. 



CCPPH1 



CCPBLB 



CCPVAR 



Build Step Description 

CROSS Updates the Cross program library on the CRSS source file with corrective 
code from file CODEOPL and with user corrective code from file UCRS; 
compiles the updated binaries for use by the CCP build steps; writes an 
updated version of CRSS file. If you do not want to install CCP, skip the 
remaining build steps. 

Updates the program libraries on the CCPB, CCPD, CCPT, and CCPR files with 
corrective code from file CODEPL and then merges the updated program 
libraries into file PCMB; creates updated program libraries of CCP (PCCP), 
online diagnostics (PDGN), the 3270 TIPt (PBST), and remote concentrator 
products (PREM) and any other user-supplied program libraries; updates PCMB 
with temporary user-supplied corrective code from file UCCP and generates 
the phase 1 (micromemory) and dump load modules on file ZMUX; creates EXPAND 
and Autolink binaries; builds system autostart (SAM) load module; writes 
updated versions of CCPD, CCPT, and/or CCPR. 

Updates the PCMB program library with temporary user-supplied corrective 
code from file UCCP and generates the CCP object code library (BCMB); writes 
an updated version of CCPB. This build step is also called the CCP full 
compile and assembly build step. 

Updates the PCMB program library with temporary user-supplied corrective 
code from file UCCP and generates a CCP variant load module (Zvvv) and 
program initiation control block (PICB) file (Ivvv) from the BCMB file 
according to the user-specified variant definitions in file USERBPS; writes 
Vvw. This build step should be repeated for each NPU in the network. 

Patches a CCP variant load module. This build step is not part of the 
normal build process but allows the use of the MPEDIT utility of Cross. 

Updates the PCMB program library with temporary user-supplied corrective 
code from file UCCP and generates a NAM network load file (Gzzz) via program 
LFG (refer to the NOS 2 Analysis Handbook). The load file includes the 
phase 1 and dump load modules (file ZMUX) and system autostart load module 
(file ZSAM) from step CCPPH1, and the variant load modules (Zwv ± ) and 
PICBs (Ivw) from step CCPVAR. 

Purges the noncritical permanent files created by the other build steps. It 
does not purge the load file from build step CCPLOAD and the user-supplied 
files. This build step is not required; it is only a cleanup utility. 
However, since previous build steps do not purge the noncritical permanent 
files, it is suggested that CCPPURG be run to make more disk space available. 

The final result of the CCP/Cross build steps is the generation of a NAM network load file. 
Figure 5-1 illustrates the build step dependencies. Figure 5-2 illustrates the relationship 
of the load file to the release files and the other files critical to the CCP build 
process. Figure 5-3 illustrates the relationship of build steps to critical files and tapes 
involved in CCP installation. 



CCPEDIT 



CCPLOAD 



CCPPURG 



t Terminal Interface Program. 
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CROSS 
1 



CCPPH1 
2 



CCPBLB 
3 



CCPVAR ] 
4 



(CCPLOAD) 
6 





Figure 5-1. CCP/CROSS Build Step Dependencies 
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Figure 5-2. CCP File Dependencies 
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New On-Line 
Diagnostics PL (PDGN)t 



New Remote Overlay 
PL (PREM)t 



New 3270 TIP 
PL (PBST)t 



CCPPH1 
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CCPBLB 

A 
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Dump Load 

Modules (ZMUX) 
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Load Module 

(ZSAM) 
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Variant Load 
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Definitions 

and Load File 

Definitions 

(USERBPS) 



CCPVAR 



) ( 



CCPLOAD 



Variant Load 
Modules (Zvvv) 

and PICB 

Load Modules 

(Ivvv) 



) 




Figure 5-3. Integration of Program Libraries in CCP Build Process 
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BINARY INSTALLATION OPTION 

To speed up the process of installing CCP/Cross, Control Data provides the following 
prebuilt files on the permanent file tapes: 

• All permanent files necessary to begin the build process with the CCPVAR step. 

• Several CCP variants and a load file. The Software Release Bulletin (SRB) describes 
these variants. 

Thus, you can skip the first three steps of the build process (the CROSS, CCPPH1 , and CCPBLB 
steps) if these two conditions are true: you do not want to add user code to the the omitted 
build steps and you do not need to add online diagnostics or the 3270 TIP. (If you ordered 
the Remote Concentrator Products, they are included in the CCP files.) 

To perform a CCP binary installation, enter: 

SYSGEN ( SOURCE , CCP ) 

This command loads all CROSS and CCP permanent files and the USERBPS file to your user 
name. If you can use both the CROSS and CCP files, modify the LFD and VRD statements in 
file USERBPS and begin your CCP/Cross installation with the CCPVAR step. If you can use 
only the CROSS binaries, you should create your USERBPS file and begin your installation 
with the CCPPH1 step. 



NOTE 



Complete CCP/Cross and variant build 
listings (as provided by the LIST=PF option) 
are provided on the permanent file tapes in 
the CCP/Cross and variant release files. 
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GENERAL BUILD STEP CALL 

All CCP/Cross build steps are called by the BEGIN conmand. Descriptions of each of the 
seven sequential build step procedures, including the required BEGIN parameters, are in 
subsequent subsections. Table 5-4 summarizes the tape and disk file requirements of the 
build steps. 



Table 5-4. CCP/Cross Tape and Disk File Requirements 



Build 


Build 


Input Files 


User 


Permanent 


Optional 


Step 


Step 


Generated by 


Input 


Files 


Permanent 


Order 


Name 


Previous Step 


Files 


Created 


Files Created 


1 


CROSS 


UCRS 


Addd 

USERCHG 

CODEPL 


LCRB 
PCRS 




2 


CCPPH1 




UCCP 


ZMUX 


LIMC 








USERCHG 


PCMB 


LMFB 








CODEPL 


PCCP 
ZSAM 

Addd 
SMUX 


PDGN 
PREM 
PBST 
LSAM 


3 


CCPBLB 


PCMB 
ZMUX 
ZSAM 
SMUX 
Addd 


UCCP 

USERCHG 

USERBPS 


BCMB 


LFCA 


4 


CCPVAR 


PCMB 


UCCP 


Zvw 


Lvw 






BCMB 


USERBPS 


Svw 








SMUX 


USERCHG 


Ivw 




5 


CCPEDIT 


Zvw 


UEDZ 


Zyyy 






(optional) 


Svw 


USERCHG 


Syyy 




6 


CCPLOAD 


PCMB 
ZMUX 
ZSAM 
Zvw 
Ivw 


UCCP 

USERBPS 

USERCHG 


Gzzz 




7 


CCPPURG 
(optional) 




USERCHG 







I 
I 
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When you are building CCP/Cross from an auxiliary disk pack, use the PACKNAM command (refer 
to the NOS 2 Reference Set, Volume 3) before calling the CCP/Cross procedure. 

The format of the BEGIN command follows: 

BEGIN, pname, INSTALL, pj ,p 2 P n - 

pname is the name of the build step procedure. The common parameters LIST, NOECS, NOWRT, 
and NOPURGE can be set in file COMMOD with the values described below. Refer to appendix B 
for information about modifying parameters in file COMMOD. 

Parameter Description 

Pj=p n Build step parameter. The order-independent format should be used. 

BSTP=bst Specifies whether the 3270 TIP program library is present; used only with 
CCPPH1. If this parameter is omitted, BSTP=N0 is assumed. 

DIAG=diag Specifies whether online diagnostics are present (CCPD); used only with 
CCPPH1. If this parameter is omitted, DIAG=N0 is assumed. 

GN=file Specifies load file name. The user supplies the 3-character, alphanumeric 
file name; used only with CCPLOAD. 

LIST=option Specifies whether the build step creates a listing, saves the listing as a 
permanent file on disk, and/or assigns the listing to OUTPUT. Do not 
specify this parameter for the CCPLOAD build step. The default is LIST=N0. 

YES Listing is assigned to OUTPUT. For the CCPVAR build step, 

listing is assigned to OUTPUT and is copied to the new release 
file. 



PF 



BOTH 



Listing is stored as a permanent file on disk; later it is 
copied to the new release file and purged from the disk. 

Listing is stored as a permanent file as well as assigned to 
OUTPUT; later it is copied to the new release file and the 
permanent file is purged. 



NO 



No listing is created. 



NEW=yyy 



NOECS 



NOPURGE 



N0WRT=nn 



Specifies new CCP variant name for patched load module; used only with 
CCPEDIT. Supply the 3-character alphanumeric name. 

Specifies for build steps CCPPH1 and CCPBLB that extended memory is not 
used. Supply this parameter only when extended memory is down or when you 
do not want to use extended memory even if it is available. This parameter 
is not required if there is no extended memory or if fewer than 77000g 
words of extended memory are available. 

Specifies that routine DRTBAT1 does not purge files PCCP, LIMC, LMFB, LSAM, 
and LFCA. If NOPURGE is omitted (the default value), the files are purged. 

Specifies whether routine DRTBAT1 writes new files. The default is 
N0WRT=N0. If you want the DRTBAT1 routine to write new files, specify 
N0WRT=YES. 
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Parameter Description 

OLD=xxx Specifies CCP variant to be patched; used only with CCPEDIT. Supply the 
3-character alphanumeric name. 

PC= P C Controls the inclusion of code to update the released program libraries 

from the previous release to the PSR summary level of the current release. 
If the product program library was included with the current installation 
materials, PC=NO should be used. The default is PC=NO. 

REMT=remt Specifies whether remote concentrator products are present (CCPR); used 

only with CCPPH1 (Link Interface Program). If this parameter is omitted, 
REMT=NO is assumed. 



VN-vw Specifies a variant name that matches the variant name in the VRD 

definition in USERBPS; used only with CCPVAR. 

Specifies the variant name that was used in CCPVAR; used only with 
CCPPURG. x is an integer within the range 1 through 10. 

Specifies whether the build step generates a cross-reference listing of the 
Pascal source of CCP; used only with CCPBLB. If this parameter is omitted, 
XREF=NO is assumed. 

XTRAPLS=xtrapls Specifies whether extra program libraries are to be merged into the PCMB; 

used only with CCPPHl. If this parameter is omitted, XTRAPLS=NO is assumed. 



Vx=vw 



XREF-xref 



SECURITY CHARACTER PARAMETERS 

The specification of a security character for a particular TIP activates the secure login 
feature. This feature guarantees that the terminal user can request a connection to the 
Network Validation Facility (NVF) regardless of any action by a host program. As a result, 
the login information the user enters remains secure. The installer is responsible for 
maintaining the integrity of the network configuration files (NCF and LCF) such that the NVF 
login or autologin is not subverted. 

When the terminal user enters the security character in a specific sequence (refer to the 
NOS 2 Reference Set, Volume 3), CCP terminates any current connection and either reconnects 
the user to the host computer or prompts the user to select or connect to a host computer. 

The security character must be a 7-bit character (specified as a hexadecimal number) that is 
within the code set of the terminal specified in ASCII. The character is restricted to the 
values $03-$lF, $21-$2F, $3A-$3C, $3E-$40, $5B-$60, and $7B-$7E. The security character 
must not be the same value as specified for the abort block, backspace, user break 1, user 
break 2, cancel, control, end-of-line, or end-of -block character. Refer to the Network 
Definition Language Reference Manual for the default values for these characters. For any 
sub-TIP for which a security character is not specified (that is, value equals $00), the 
secure login is not activated. 
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I Here are the parameter values in deck SECURITY the CCPB PL. 



Parameter 


Default 
Security 
Character 


SCAN2741 


$00 


SCA2741 


$00 


SCB3270 


$00 


SCMD4A 


$00 


SCMD4C 


$00 


SCHPOST 


$00 


SCHPRE 


$00 


SCB2780 


$00 


SCB3780 


$00 


SCXPAD 


$00 


SCXUSER 


$00 



Terminal 
Asynchronous non-2741 terminals 
Asynchronous 2741 terminals 
IBM 3270 terminals 
Mode 4A terminals 
Mode 4C terminals 
HASP postprint terminals 
HASP preprint terminals 
IBM 2780 terminals 
IBM 3780 terminals 

X.25 package assembly /disassembly (PAD) terminals 
X.25 user-defined terminals 
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CROSS-CROSS SYSTEM INSTALLATION 

The following build step generates updated program binaries for all Cross programs and 
ttl^llll th °* e P ro gf™s ^eded for the following CCP build steps. Refer to General Build 
Step Call, earlier in this section, for descriptions of the parameters. 

BEGIN, CROSS, INSTALL, LIST=option,PC=pc. 
The CROSS build step uses the following files for input. 



File 
OSERCHG 

CRSSpsrin 
UCRS 

CODEPL 



Descript ion 

User/charge file. It is optional for all build steps (refer to CCP/Cross 
Permanent Files, later in this section). u^/cross 

Cross release file. 

Optional site corrective code (refer to CCP/Cross Permanent Files, later in 
l™\T%tZ a I 3 des «iPti°n of the Cross installation parameters that 

can be changed, refer to Installation Parameters for CROSS, later in this 
subsection. 

Cross corrective code, if any, that affects the resulting Cross binaries but 
is not placed in the program library on the output file. 



The CROSS build step creates the following output files. 



File 

CRSSpsrout 

LCRB 

APAS 

AASM 

AMAC 

AFMT 

ASMAS 

AXRF 

ALNK 

AEDT 

ALIB 

ACYP 



Description 
New CRSS file. 

Cross system listings (if requested). 
MP17 Pascal compiler. 
Cross macro assembler. 
Macro assembler text file. 
Pascal binary output formatter program. 
Cross micro assembler. 
Pascal cross-reference program. 
MPLINK program. 
MPEDIT program. 
MPLIB program. 
CYBER 170, CYBER 70, and 6000 Computer Systems Pascal compiler. 
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Examples : 

You can execute the CROSS build step by using any of the following methods. 

BEGIN , CROSS , INSTALL . 

The build step generates no listings and installs the corrective code. 

BEGIN , CROSS , INSTALL , LIST=YES . 

The CROSS build step copies its listings (LCRB) to OUTPUT. By default, the build 
step Installs the corrective code. 

BEGIN .CROSS, INSTALL ,LIST=PF ,PC=NO. 

The corrective code on file CODEPL (Update-formatted) makes corrections to the file 
CRSSpsrout. 

The following parameters are in deck CROSS. 

Identifier Parameter Default Significance 

Maximum number of global symbols minus one. 

(SYMTBSIZ/32)-l. 

Size of in-core symbol table. 

MAXGLBL/32. 

Size of in-core symbol table. 

Maximum number of global symbols minus one. 

The number of entries in the in-core symbol table in the release version of the Pascal 
compiler is 1792. This version of the compiler has a corresponding maximum number of global 
symbol definitions of 1536 and an execution field length of 77O00g central memory (CM) 
words. Some programs require a Pascal compiler that accommodates more than 1536 global 
symbol definitions; for example, CCP requires 6144 global symbols. Increasing the size of 
the global symbol table without increasing the in-core symbol table, however, results in a 
significant increase in compilation time. Further, an increase in the number of CM words 
must accompany any increase in the size of the in-core symbol table (4 CM words per symbol 
table entry). 



XSYA127.6 


MAXGLBL 


1535 


XSYA127.7 


HGHPAGE 


55 


XSYA127.8 


SYMTBSIZ 


1792 


XSYA127.9 


VARPAGE 


47 


XSYA127.406 


SYMTBSIZ 


1792 


XSYA127.407 


MAXGLBL 


1535 
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CCPPH1 - CCP PHASE 1 



The following build step generates a combined base program library for CCP, 3270 TIP online 

riSrf «nH S r m0t ? C ° nCe f " t0r J r °S™" libraries. It also creates the multiplexer 
firmware and the dump load module. Refer to General Build Step Call, earlier in this 
section, for descriptions of the parameters. 

BEGIN, CCPPH1 , INSTALL,DIAG=diag,REMT=remt,BSTP=bst,NOECS. 
The CCPPH1 build step uses the following input files. 



File 
USERCHG 

UCCP 

CCPB 
CCPT 
CCPD 
CCPR 
CODEPL 



Description 

User/charge file. Refer to User-Supplied Files in CCP/Cross Permanent Files, 
later in this section. 

Optional user corrective code. Refer to User-Supplied Files in CCP/Cross 
Permanent Files, later in this section. 

CCP release file. 

3270 TIP release file (if BSTP=YES). 

Diagnostic release file (if DIAG=YES). 

Remote release file (if REMT=YES). 

CCP corrective code. 



CCPPH1 generates the following output files. 



File 
PCMB 
LMFB 



LSAM 
ZMUX 



PCCP 

PDGN 

PBST 

CCPDpsrout 

CCPRpsrout 



Description 
Updated combined program library. 
CCP list file. 

File 1 Multiplexer firmware. 
File 2 Dump bootstrap overlay. 
System autostart (SAM) listing (if requested). 
CCP load module. 

File 1 Multiplexer firmware. 
File 2 Dump bootstrap overlay. 
New CCP program library, including corrective code from CODEPL. 
New diagnostic program library, including corrective code from CODEPL. 
New 3270 TIP program library, including corrective code from file CODEPL. 
New diagnostic file (if DIAG=YES). 
New remote file (if REMT=YES). 
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File Description 

CCPTpsrout New 3270 TIP file (if BSTP=YES). 

PREM New remote program library, including corrective code from CODEPL. 

SMUX Dump bootstrap symbol table. 

ZSAM SAM load module. 

AEXP Build parameters expand program binary. 

AALK Autolink program binary. 

L1MC Listing of Expand and Autolink programs. 

Examples: 

You can execute the CCPPH1 build step in several different ways, including the following: 

BEGIN , CCPPH1 , INSTALL ,BSTP=YES ,DIAG=YES , REMT-YES . 

BSTP=YES, DIAG=YES, and REMT=YES signify that the 3270 TIP, online diagnostics, and 
the remote dump/load overlay are to be installed. This command selects the default 
for corrective code use. 

BEGIN, CCPPH1, INSTALL, DIAG=YES. 

DIAG=YES signifies the presence of the online diagnostics. This command selects the 
defaults for listings, remote concentrator products, and corrective code use. 

BEGIN, CCPPH1 , INSTALL ,LIST=YES ,REMT=YES . 

LIST=YES automatically routes the list files to the printer. REMT=YES signifies the 
presence of the remote dump/load overlay. This command selects the defaults for 
diagnostics and corrective code use. 
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CCPBLB ■ CCP BINARY LIBRARY 

The following build step generates an updated combined binary library of all CCP procedures 
and assembly language subroutines. Refer to General Build Step Call, earlier in this 
section, for descriptions of the parameters. 

BEGIN, CCPBLB, INSTALL, LIST=option,XREF=xref .NOECS. 

CCPBLB requires the following input files. 



File 
USERCHG 

USERBPS 

UCCP 

PCMB 
PCCP 
ZMUX 



AEXP 
AALK 

SMIJX 
ZSAM 



Description 

User/charge file. Refer to User-Supplied Files in, CCP/Cross Permanent Files, 
later in this section. 

User variant build parameters file. Refer to User-Supplied Files in CCP/Cross 
Permanent Files, later in this section. 

Optional user corrective code. Refer to User-Supplied Files in CCP/Cross 
Permanent Files, later in this section. 

Updated combined program library. 

New CCP program library including corrective code from CODEPL. 

CCP load module. 

File 1 Multiplexer firmware. 

File 2 Dump bootstrap overlay. 
Build parameters expand program binary. 
Autolink program binary. 
Dump bootstrap symbol table. 
SAM load module. 



CCPBLB produces these output files. 

File Description 

CCPBpsrout CCP release file. 

BCMB Combined CCP/diagnostics/remote binary library. 
LFCA Full compile assembly listings. 

File 1 Assembly source listing. 

File 2 Pascal source and object listing. 
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Example: 

BEGIN, CCPBLB , INSTALL ,LIST=YES ,XREF=YES . 

LIST=YES routes the listings generated by CCPBLB to the printer and does not make 
them a permanent file. XREF=YES causes the XREF program to generate a 
cross-reference listing of the Pascal source of CCP. 



CCPVAR - CCP VARIANT 

The following build step generates a CCP variant (phase 2) load module and a PICB load 
module based on user-supplied variant definitions on file USERBPS. Refer to General Build 
Step Call, earlier in this section, for descriptions of parameters. 

BEGIN , CCPVAR , INSTALL ,LIST=option ,VN=wv. 

CCPVAR requires the following input files. 

File 



USERCHG 

UCCP 

PCMB 
BCMB 
USERBPS 

SMUX 



Description 

User/charge file. Refer to User-Supplied Files in CCP/Cross Permanent Files, 
later in this section. 

Optional user corrective code. Refer to User-Supplied Files, in CCP/Cross 
Permanent Files, later in this section. 

Updated combined program library. 

Combined CCP/diagnostics/remote binary library. 

User variant build parameters file. Refer to User-Supplied Files, later in 
CCP/Cross Permanent Files, later in this section. 



Dump bootstrap symbol table from CCPPH1 build step. 
CCPVAR generates the following output files. 
File 

Variant release file. 



Description 



Vvw 

Zvw 

Ivw 

Svw 

Lvw 

Example: 

BEGIN, CCPVAR, INSTALL, VN=FEP. 

This command selects the defaults for listings. VN=FEP creates the files ZFEP, 
IFEP, SFEP, and LFEP (a load module, a PICB, a symbol table, and listing, 
respectively) . 



CCP variant load module (vvv is the variant name). 

PICB load module. 

Symbol table for CCP variant load module Zvw and PICB load module Iwv. 

Variant load module and PICB listing. 
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CCPEDIT - CCP LOAD MODULE FILE EDIT 

The following build step patches an absolute CCFLOAD module (file named Zvw, where wv is 
the CCP variant load module) via a special MPEDIT run (refer to CYBER Cross System Build 
Utilities Reference Manual). The CCP build process requires this step only for those cases 
where there is a minor difference between an existing load module and the desired load 
module. Refer to General Build Step Call, earlier in this section, for descriptions of the 
parameters. 

BEGIN .CCPEDIT , INSTALL , OLD=vw 1 , NEW=vw 2 . 

CCPEDIT requires four input files. 

File Description 

USERCHG User/ charge file. Refer to User-Supplied Files in CCP/Cross Permanent Files, 
later in this section. 

Zwvj CCP variant load module vwj. 

UEDZ Optional direct or indirect access permanent file of MPEDIT directives to 

patch a CCP variant load module. Refer to User-Supplied Files in CCP/Cross 
Permanent Files, later in this section. 

Swvi Symbol table associated with variant load module vwj. 

CCPEDIT produces two output files. 

File Description 

Zvw2 New CCP variant load module reflecting patch code. 

Svw2 Copy of symbol table Svwj . 

Example: 

BEGIN, CCPEDIT, INSTALL, 0LD=FEP,NEW»FE2. 

CCPEDIT patches variant FEP with MPEDIT patch code directives from UEDZ to create a 
new variant FE2. 
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CCPLOAD - GENERATE CCPLOAD FILE 

Based on user-supplied load file definitions on file USERBPS, the following build step 
generates a CCP load file used by network access method/network supervisor (NAM/NS) to 
downline load network processor units (NPUs). Refer to General Build Step Call, earlier in 
this section, for a description of the parameter. 

BEGIN , CCPLOAD , INSTALL , GN=zz z . 

CCPLOAD requires these input files. 

Flle Description 

PCMB Updated combined program library. Refer to User-Supplied Files in CCP/Cross 
Permanent Files, later in this section. 



USERCHG 



UCCP 



USERBPS 



ZMUX 



User/charge file. Refer to User-Supplied Files in CCP/Cross Permanent Files, 
later in this section. 

Optional user corrective code. Refer to User-Supplied Files in CCP/Cross 
Permanent Files, later in this section. 

CCP load file definitions file supplied by user. Refer to User-Supplied Files 
in CCP/Cross Permanent Files, later in this section. 



MUX firmware and dump bootstrap load module. 
ZSAM System autostart load module. 
Zvw Previously created CCP variant load module(s). 
Ivw Previously created PICB load module(s). 
CCPLOAD generates one output file. 
File Description 

Gzzz ccp load fll e (zzz is the value associated with the GN keyword). 
Example: 

BEGIN , CCPLOAD , INSTALL , GN=XYZ . 

This command uses the load file definitions on file USERBPS and creates the CCP load 
file GXYZ used by NAM/NS. 

Relocate file: 

If the released version of the NS job skeleton JOBNS is used (refer to NAM5 - Network Access 
Method Version 1 In this section), rename Gzzz file as NLFFILE and move NLFFILE to NETOPS 
(user index 377772s). 
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CCPPURG - CCP/ CROSS INSTALLATION FILES PURGE 

The following optional build step purges all noncritical permanent files created by the 
CCP/Cross installation process. This step does not purge the user-supplied files and the 
CCP load file created by CCPLOAD. Refer to General Build Step Call, earlier in this 
section, for descriptions of parameters. 

BEGIN, CCPPURG, INSTALL, VI =wvi ,V2=vw 2 Vn=vw n . 

CCPPURG requires one input file. 

File Description 

USERCHG User/ charge file. Refer to User-Supplied Files in CCP/Cross Permanent Files, 
later in this section. 

This step produces no output files. 

Example : 

BEGIN,CCPPURG,INSTALL,V1=FEP,V2=L0C,V3=REM,V4=NP1,V5=NP2. 

This command purges all permanent files associated with the variants FEP, LOC, REM, NP1, and 
NP2. A CATLIST after this procedure verifies that the system has purged all the permanent 
files created by the installation process. CCPPURG does not purge the files USERCHG, 
USERBPS, UCCP, UCRS, UEDZ, and the load file (Gzzz) created by CCPLOAD. 
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CCP/CROSS PERMANENT FILES 

All permanent files generated by the CCP/Cross installation procedures are named by the 
following convention: each name consists of 4 characters and the first character identifies 
the file type. The first character can be any of the following file types: 

File Type Description 

A Absolute load file (Cross program). 

B Binary library or LGO file. 

C Permanent corrective code in Update format with master control character 

of /. 

G CCP load file created by the load file generator (LFG) program. 

I Program initiation control block (PICB) 

L CCP/Cross listing (generated during installation). 

P Program library in Update format. 

S CCP symbol table. 

U User supplied corrective code file. 

Z Load modules required by CCPLOAO. 

An alphabetical list of permanent files generated by the CCP/Cross installation follows. 
Files are grouped by their file types. 

Absolute 
Load Files Description 



AALK Autolink program. 

AASM Cross macro assembler. 

ACYP CYBER 180, CYBER 170, CYBER 70, and 6000 Computer Systems Pascal 
compiler. 

AEDT MPEDIT program. 

AEXP Build parameters expand program. 

AFMT Pascal binary output formatter program. 

AL1B MPLIB program. 

ALNK MPLINK program. 

AMAC Macro assembler text file. 

AMAS Cross micro assembler. 

APAS MP17 Pascal compiler. 

AXRF Pascal cross-reference program. 
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Binary Library File 
BCMB 

Corrective Code File 

CODEPL 
CCP Load File 

Gzzz 

CCP/PICB Load Modules 

Ivw 
CCP/Cross Listings 

LCRB 

LFCA 

LIMC 

LMFB 

Lvw 
Program Libraries 

PBST 

PCCP 
PCMB 
PCRS 
PDGN 

PREM 

Symbol Tables 

SMUX 

Swv 



Description 
Combined CCP/diagnostics/remote binary library. 

Description 

Corrective code for CROSS/CCP/Network Host Products. 

Description 

CCP load file generated by CCPLOAD (the zzz appended to the 
letter G is the value of the GN parameter). 

Description 
CCP program initiation control block load modules. 

Description 
Cross system listings. 
Full compile assembly listings. 
Expand and autolink program listings. 
MUX firmware and dump bootstrap overlay listings. 
Variant load module listing (wv is variant name). 

Description 

New 3270 TIP program library including corrective code on 
CODEPL. 

New CCP program library including corrective code on CODEPL. | 

Updated combined program library. 

New Cross program library including corrective code on CODEPL. | 

New diagnostic program library including corrective code on 
CODEPL. | 

New remote program library including corrective code on CODEPL. | 

Description 
Symbol table for dump bootstrap. 
Symbol table for load module Zvw. 
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NOTE | 



All CCP/Cross user-supplied files must be 
permanent files under the same user name 
used for the build step jobs. The USERBPS 
and USERCHG files must be indirect access 
permanent files. The UCRS, UCCP, and UEDZ 
files can be indirect or direct access 
permanent files; local files of the same 
name are ignored. 



User-Supplied Files 



UCCP 



UCRS 



UEDZ 



USERBPS 



USERCHG 



Load Modules 
ZMUX 
ZSAM 
Zvw 



Description 

Optional direct or indirect access permanent file of user code 
corrections to CCP. The contents of this file should be the 
same for all build steps requiring it. 

Optional direct or indirect access permanent file of user code 
corrections to Cross. This file may be used only with build 
step CROSS. 

Optional direct or indirect access permanent file of MPEDIT 
directives to patch a CCP variant load module. This file may 
be used only with build step CCPEDIT. 

User build parameters file. This indirect access permanent 
file contains the CCP system definition, the CCP variant load 
module definitions, and the CCP load file definitions. This 
file is required for build steps CCPBLB, CCPVAR, and CCPLOAD. 
For each execution of CCPVAR, the USERBPS file must remain 
unchanged. A complete description of USERBPS immediately 
follows the listing of the permanent files. 

User /charge file. This indirect access permanent file 
contains the USER command, the CHARGE command (if required), 
and commands that are executed at the start of the build 
step. This file is required for all build steps done from a 
terminal. If a CCP/Cross installation procedure is executed 
from a batch job, omit the USERCHG file. 

Description 

MUX load module firmware and dump bootstrap overlay. 

SAM load module. 

CCP variant load module (vw is variant name) . 



NOTE 



If the CCP/Cross build process is 
interrupted, you must ensure that the 
required files are present upon resumption. 
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USERBPS File: 

Create a build parameters file (indirect access permanent file USERBPS) containing a CCP 
system definition, CCP variant load module definitions, and CCP load file definitions. 
Build steps CCPBLB, CCPVAR, and CCPLOAD require this file. During the build step CCPPH1 , 
the utility program EXPAND searches through USERBPS for the extra program library 
definitions. During build step CCPBLB, the utility program EXPAND searches through USERBPS 
for the system (SYS) definition. It then expands the definition, according to a macro text 
file, into Update directives that control the options and TIPS that are assembled and 
compiled into the combined binary library (BCMB). For build steps CCPVAR and CCPLOAD, 
parameters specify the desired variant or load file definition. EXPAND then searches for 
and expands the definition in the same manner as described for the system definition. The 
Update directives created cause input to be generated for the AUTOLINK program. 

USERBPS can contain any number of CCP system, variant, and load file definitions. (Refer to 
the sample USERBPS file at the end of this section. ) If more than one system definition is 
present, only the first definition is used. The format of CCP build definitions follows: 

keywordi=valuei ,keyword2=value2, ... ,keyword n =value n . 
When a keyword takes on multiple values, the form follows: 

keywordj=value|/value2/« • • /value n . 
This is equivalent to the following: 

keywordj=valuej ,keywordj=value2, • • • ,keywordi=value n . 
The following syntax rules apply to all definitions. 

• The first keyword must be one that identifies the type of definition (VRD indicates 
a variant definition and LFD indicates a load file definition). 

• EXPAND ignores all embedded blanks. Blank lines are illegal. 

• A period terminates each definition. 

• Continuation lines must begin with a plus (+). 

• EXPAND treats any line whose first character is an asterisk (*) as a comment line. 

• When a definition takes more than one line, the user should break the definition 
between parameter pairs. 
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CCP SYSTEM DEFINITION 

| The system definition controls the options and terminal interface programs (TIPs) that are 
assembled and compiled into the combined binary library (BCMB). It is similar to the 
variant definition (described in the following subsection), but must include all options and 

| all TIPs that are used in any variants to be built from the resulting combined binary 
library. 

The system definition can continue over more than one line as long as each line prior to the 
last ends with a comma. The last line must end with a period. The system definition has 
two parts, either of which may be present or absent. The resulting four formats are as 
follows . 



Format 
SYS. 

SYS=<optIons>. 
SYS,TS=<TIPs>. 
SYS=<options>,TS=<TIPs>. 
Keyword 



SYS=vl/v2/v3 



TS^j/tg/. 



Significance 
No options, no TIPs. 
Options present, no TIPs. 
TIPs present, no options. 
Both options and TIPs present. 
Description 
Specifies options if present. 



vi Description 

C Support modules for CONSOLE (for printing CCP 

information on a terminal connected to a 2550) are 
compiled. 

D Online diagnostic support modules are present. 

P Support modules for statistics on line/ trunk /NPO 

performance, which are logged on the account dayfile and 
the error log file, are compiled. 

R Remote concentrator products are present. 

T Support modules for TUP (test utility program) and 

CONSOLE are compiled. (TUP is an unsupported product.) 

Specifies the TIPs that are to be included in the system. TS can 
assume up to 10 different order-independent values. 

tj Description 

A Asynchronous TIP is included. This TIP supports ASCII 
terminals, APL character sets, and IBM 2741 terminals. 

B Binary synchronous communications (BSC) TIP is 

included. This TIP supports the IBM 2780 and IBM 3780 
terminals. 

H HASP TIP Is included. 
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Keyword Description 

t£ Description 

M Mode 4 TIP Is Included. 

T 3270 TIP Is Included. 

XP X.25 TIP and PAD sub-TIP is Included. Specify this TIP 
for any variant that executes in an NPU connected to a 
packet switching network. 

XA X.25 TIP and application-to-appllcation sub-TIP is 
included . 

1 User TIP1 is included. 

2 User TIP2 Is included. 

3 User TIP3 Is included. 

The following example includes all the options and TIPs specified in the examples shown for 
the variant load module definition. 

SYS-R/D/T ,TS=A/B/H/M/XP/XA. 



CCP VARIANT LOAD MODULE DEFINITION 

The variant load module definition can continue over more than one line as long as each line 
ends with comma, except the last line must end with a period. 

The format follows: 

VRD-vvv ,VT=V! /V2/V3 , SZ=xK ,TS=t i / t2/ . . • / t n . 

Keyword Description 

VRD=vw Identifies entry as a variant definition and specifies variant 

name (associated wv value). Build step CCPVAR uses wv to 
create unique permanent file names. Specify a 3-character 
alphanumeric string, beginning with an alphabetic character. It 
must not be the same as the last 3 characters of the CCP/Cross 
permanent file names (refer to CCP/Cross Permanent Files , 
earlier in this section). 

VT=V]7v2/v3 Specifies variant type of the NPU. You can associate a maximum 
of three separate values with VT. One of the following values 
must appear. 

v^ Description 

F Front-end; includes Host Interface Program (HIP) but no 
Local Interface Program (LIP). 

L Local; includes HIP and LIP. 

R Remote; includes LIP but no HIP. 
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Keyword Description 

The following values are optional. 

Vj Description 

C Variant Includes module CONSOLE. 

D Variant includes online diagnostic support modules. 

P Variant includes modules for statistics/performance 

results. 

T Variant includes modules TUP and CONSOLE for debugging. 

Examples : 

VT=L/D/T 

VT=F/D 

VT-R 

SZ=xK Specifies variant memory size: 65K, 81K, 96K, or 128K (x is a 2- or 

3-digit number) . 

TS=ti/t2/... Specifies which Terminal Interface Programs (TIPs) are to be included 
in this variant. TS can assume up to 10 different order-independent 
values. 

t± Description 

A Asynchronous TIP is included. This TIP supports the 

ASCII terminals, APL character sets and IBM 2741 
terminals . 

B Binary synchronous communications (BSC) TIP is 

included. This TIP supports the IBM 2780 and IBM 3780 
terminals. 

H HASP TIP is included. 

M Mode A TIP is included. 

T 3270 TIP is included. 

XP X.25 TIP and PAD sub-TIP is included. Specify this TIP 

for any variant that executes in an NPU connected to a 
packet switching network. 

XA X.25 TIP and application-to-application sub-TIP is 

included . 

1 User TIP1 Is included. 

2 User TIP2 is included. 

3 User TIP3 is included. 
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Example 1: 

VRD-EX1 ,VT«L/D,SZ=81K,TS=A/M. 

S^nosSc" 8UPP ° rtS ^ 81K l0Cal NPU W±th a8 y» ch "no^ *„d mode 4 TIP 8 and online 

Example 2: 

VRD=EX2 ,VT=R/C ,SZ=96K,TS=A/H/XP. 

This variant supports a 96K remote NPU with HASP, X.25 PAD, and asynchronous TIPs 
This variant does not support online diagnostics but supports a 2 ! St console. 

Example 3: 

VRD=EX3,VT=F/D/T,SZ=128K,TS=A/B/H/M/XP/XA. 

This variant supports a 128K front-end NPU with no remote NPUs, all TIPs (excent 
site-defined TIPs), and online diagnostics. This variant supports a 2550 coZle. 
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CCP LOAD FILE DEFINITION 

The format follows: 

LFD=zzz ,UI=vwi /vw2/ . • • /vw n . 

Keyword Description 

LFD Identifies entry as a load file definition and specifies the last 

3 characters of the load file name (associated zzz value). The zzz 
value must be a 3-character alphanumeric string matching the 
corresponding GN=zzz parameter in the build step CCPLOAD. CCPLOAD 
uses this value to create a unique permanent file name for the output 
file, zzz must not be the same as the last 3 characters of any of the 
CCP /Cross permanent file names (refer to CCP /Cross Permanent Files, 
earlier in this section). 

LM Specifies the CCP variant load modules and PZC8 load modules to 

include in this load file. The MUX firmware (phase 1), dump load, 
dump bootstrap, and SAM modules are automatically included in every 
load file. The associated value wvj is the 3-character name of a 
variant load module ( file name ZvwJ that was generated by the 
CCPVAR build step. Repeat the vwj specification (separated by 
slants) for each variant to be included in the load file. 

Example 1: 

LFD=EX4 ,LM=EX1 /EX2/EX3 . 

This entry defines a load file containing the variants created in the three CCP 
variant definition examples. 

Example 2: 

LFD-EX5,LM=EX3. 

This entry defines a load file containing only the variant in the third CCP variant 
definition example. 

CCP EXTRA PIS DEFINITION 

The format follows: 

PLS=ppp 1 /ppp 2 / PP p 3 /. . ./p pPn . 

Keyword Description 

PLS Identifies entry as an extra PL definition and specifies which 

user-supplied PLs should be merged into PCMB. This entry is used by 
the CCPPH1 step. 
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CCP/ CROSS INSTALLATION EXAMPLES 

Examples follow which illustrate installation of CCP in three network configurations: one 
NPU, three NPUs (two local NPUs and one remote NPU), and a multihost configuration with 
three hosts and two NPUs. 

• All examples require the following input files. 

Files Description 

USERCHG Required for all build steps; contains USER and CHARGE commands. 

UCCP Required for user-suggested or PSR code for CCP. 

USERBPS Required for CCPBLB, CCPVAR and CCPLOAD; contains CCP system 
definitions, variant definitions and load file definitions. 

UCRS Required for user-suggested or PSR code for Cross. 

• In the build steps, all examples use the defaults for auxiliary pack device type and 
inclusion/exclusion of corrective code. 

• In all examples, underlined and lettered parameters indicate the interdependence 
among USERBPS definitions, EQPDECK entries, NDL source input, and build steps. 
Parameters with the same letter must match within each example. 

Example 1: One NPU 

The configuration includes the following. 

8 IK NPU. 

Mode 4 TIP. 

Asynchronous TIP. 

No remote node support software. 

No NPU console support. 

No online diagnostics. 
The following procedure illustrates the installation of CCP with a single NPU. 

1. Ensure that the required files and tapes are available. Refer to figure 5-4 for 
appropriate USERBPS definitions, EQPDECK entries, and NDL source input. 

2. Install Cross. 

BEGIN,CROSS , INSTALL . 

This step requires CRSS and a field length of 110K. Cross is needed for the CCP 
build process. 
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I 3. Build the phase 1 (microcode and dump bootstrap) and SAM load modules. 

BEGIN , CCPPH 1 , INSTALL . 
1 This step requires CCPB. 

4. Create an updated combined binary library of all CCP Pascal procedures and assembly 
language subroutines. 

BEGIN ,CCPBLB , INSTALL ,LIST=PF , XREF=YES . 

LIST=PF stores the listings on disk as permanent files during the build job. At the 
end of the job, the files are copied to the new release file and purged. XREF=YES 
generates a Pascal cross-reference listing. 

5. Create the phase 2 variant load module. 

b 
BEGIN , CCPVAR, INSTALL , LIST=PF , VN=VN1. 

The load module has a file name of ZVN1 and the PICB has a file name of IVN1. 
LIST=PF stores the listings on disk as permanent files during the build job. At the 
end of the job, the files are copied to the new release file and purged. 

6. Create the load file used by NAM/NS to downline load the NPU. 

g 
BEGIN , CCPLOAD , INSTALL , GN=EJQ. 

The load file name is GEX1. 
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ASYNC TIP 
MODE 4 TIP 
8 IK MEMORY 



NO ONLINE DIAGNOSTICS 

NO REMOTE 

NO NPU CONSOLE 



*USERBPS 

*ONE NPU EXAMPLE 

* 

*2550 WITH: 
* 

* 

*SYSTEM DEFINITION IS 
* 

* a 
SYS , TS=A/M . 
* 

♦VARIANT DEFINITION IS 

* b a' 
VRD=VN1 , VT=F , S Z-8 1 K , TS-A/M. 

*LOAD FILE DEFINITION IS 

* g b 
LFD=EX1,LM=VN1. 



NCF2P1:NFILE. 

b 
NP1:NPU NODE=3, VARIANT=VN1. 

SUPLINK LLNAME=LL23. 

COUP2: COUPLER NODE =2, HNAME=HOSTl. 

LL 23 : LOGLINK NCNAME=NP 1 . 
END. 

EQ4 1 =NP , ST=ON , EQ=7 , P 1= 1 , CH=5 , ND=2 , SA=OFF . 



USERBPS 
definition 



a" must be a subset of a 



NDL Source 
Input 



EQPDECK 
Entry 



Figure 5-4. USERBPS Definitions, NDL Source Input, and EQPDECK Entry for Example 1 
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Example 2: Three NPUs 

Figure 5-5 illustrates the configuration of the network for this example. It shows the size 
of each NPU, the external connections (trunks, lines, and/or coupler) to each NPU, and the 
interface programs (TIPs and HIP and/or LIP) included in each NPU. It also shows the node 
number and port assignment(s) and/or NDL name for major components in the network as chosen 
for this example. In the configuration shown in figure 5-5: 

• NPUA has three TIPs, a HIP, and a LIP. The latter two programs are required for the 
coupler and trunk, respectively. 

• NPDB has two TIPs as well as a HIP and a LIP. 

• NPUC has three TIPs and a LIP. A HIP is not required since no coupler is used. 

NPUA and NPUC have online diagnostics; NPUC has console support. NPUC can communicate with 
the network through the remote node software of either NPUA or NPUB. 

The following procedure illustrates the installation of CCP with a network configuration as 
shown in figure 5-5. 

1. Ensure that the required files and tapes are available. Refer to figure 5-6 for 
appropriate USERBPS definitions, EQPDECK entries, and NDL source input. 

2. Install Cross. 

BEGIN , CROS S , INS TALL . 
This step requires CRSS and a field length of 110K. 

3. Build the phase 1 (microcode and dump bootstrap) and SAM load modules. 

BEGIN ,CCPPH1 , INSTALL ,LIST=PF ,DIAG=YES ,REMT=YES. 

This step requires CCPB, CCPD, and CCPR. LIST=PF stores the listings on disk as 
permanent files; DIAG=YES specifies that online diagnostics are present; REMT=YES 
specifies that remote concentrator products are present. 

4. Create an updated combined binary library of all CCP Pascal procedures and assembly 
language subroutines. 

BEGIN ,CCPBLB, INSTALL ,LIST=BOTH ,XREF=YES. 

This step requires CCPB. LIST=BOTH routes the listings to the printer and stores 
them as permanent files during the build job. At the end of the job, the files are 
copied to the new release file and purged. XREF=YES generates a Pascal 
cross-reference listing. 

5. Create the phase 2 variant load module for NPUA. 

a 
BEGIN , CCPVAR , INSTALL ,LIST=PF , VN=VNA. 

LIST=PF stores the listings as permanent files during the build job. At the end of 
the job, the files are copied to the new release file and purged. The load module 
file name is ZVNA, and the PICB file name is IVNA. 
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Figure 5-5. Network Configuration - Example 2 

6. Create the phase 2 variant load module for NPUB. 

b 
BEGIN .CCPVAR, INSTALL , VN-VNB. 

The load module file name is ZVNB and the PICB file name is IVNB. 

7. Create the phase 2 variant load module for NPUC. 

c 

BEGIN , CCPVAR , INSTALL , LIST=PF , VN-RMC. 

The load module file name is ZRMC and the PICB file name is IRMC. LIST=PF stores 
the listings as permanent files during the build job. At the end of the job, the 
files are copied to the new release tape and purged. 

8. Create the load file used by NAM/NS to downline load the NPUs. 

n 
BEGIN , CCPLOAD , INSTALL , GN=EX3 . 

The load file name is GEX3. 
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*USERBPS 

*THREE-NPU EXAMPLE 
* 

*SYSTEM DEFINITION IS 

* edf ghijk 
SYS=R/D/C , TS=A/B/H/M/XP . 

*VARIANT DEFINITIONS ARE 

* a d g i k 
VRD=VNA, VT=L/D , SZ=1 28K, TS=A/H/XP . 

* b ji 
VRD=VNB , VT=L , SZ=96K ,TS=M/H. 
* 

* c edf jhk 
VRD=RMC , VT=R /D /C , S Z=96K , TS=M/B /XP . 

*LOAD FILE DEFINITION IS 
* 

* n a b c 
LFD=EX3 , LM=VNA/VNB/RMC . 

NCF2P1: NFILE. 

a 
NPUA: NPU N0DE=4, VARIANT=VNA. 

SUPLINK LLNAME=LL24. 

COUP2: COUPLER NODE=2,HNAME=HOSTl. 

LL24: LOGLINK NCNAME=NPUA. 

LL26: LOGLINK NCNAME=NPUC. 

b 
NPUB: NPU NODE=5, VARIANT=VNB. 

SUPLINK LLNAME=LL3 5 . 

COUP3: COUPLER NODE=3, HNAME=HOSTl. 

LL35: LOGLINK NCNAME=NPUB. 

LL36: LOGLINK NCNAME=NPUC. 



USERBPS 
Definitions 



NDL 
Source 

INPUT 



Figure 5-6. USERBPS Definitions, NDL Source Input, and EQPDECK Entries for Example 2 

(Sheet 1 of 2) 
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c 




NPUC: NPU N0DE=6, VARIANT=RMC. 




SUPLINK LLNAME=LL26. 




SUPLINK. LLNAME=LL36. 




TRUNK26: TRUNK N1=NPUA,N2=NPUC,P1=1 ,P2=1 . 




TRUNK36: TRUNK N1=NPUB,N2=NPUC,P1=1 ,P2=2. 




END. 




EQ41 =NP , ST=ON , EQ=7 , PI=1 , CH=5 ,ND=2 , SA=OFF . 


EQPDECK 




Entries 


EQ42=NP,ST=ON,EQ=7,PI=l,CH=5,ND=3,SA=0FF. 





Figure 5-6. USERBPS Definitions, NDL Source Input, and EQPDECK Entries for Example 2 

(Sheet 2 of 2) 



9. Execute this build step only if you want to purge extraneous files. 

a b c | 

BEGIN , CCPPURG , INSTALL , V 1 =VNA , V2 =VNB , V3-RMC . 

This step purges all extraneous permanent files associated with variant names VNA, 
VNB, and RMC. 

Example 3: Three Hosts, Two NPUs, LIP trunk 

Figure 5-7 illustrates the configuration of the network for this example. It shows the size | 
of each NPU, the external connections (trunks and couplers) to each NPU, and the interface 
programs (TIPs, HIP, and LIP) included in each NPU. It also shows the node number and port 
assignments and/or NDL names for major components in the network as chosen for this 
example. In the configuration shown in figure 5-7 the following conditions apply: I 

NPUA has four TIPs, a HIP, and a LIP. The latter two programs are required for the 
coupler and trunk respectively. 

NPUB has three TIPs, as well as a HIP and a LIP. I 

H0ST1 has NS only. 

H0ST2 has CS only. 

H0ST3 has CS only. 

PTF and QTF are installed on all three hosts. 

NPUA has the performance statistics package and console support. NPUB has online 

diagnostics. NPUA and NPUB can communicate with all three hosts in the network. | 
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The following procedure illustrates the Installation of CCP with a network configuration as 
shown in figure 5-7. 

1. Ensure that the required files and tapes are available. Refer to figure 5-8 for the 
appropriate DSERBPS definitions, EQPDECK entries, and NDL source input. 

2. Follow steps 2 through 6 in example 2. 

3. Create the load file used by NAM/NS to downline load the NPUs. 

n 
BEGIN , CCPLQAD , INSTALL , GN=EX4 . 

The load file name is 6EX4. 

4. Execute this build step only if you want to purge extraneous files. 

a b 
BEGIN , CCPPURG , INSTALL , VI =VNA, V2=VNB. 

This step purges all extraneous permanent files associated with variant names VNA 
and VNB. 
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Figure 5-7. Network Configuration - Example 3 
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* USERBPS 




* TWO-NPU, THREE-HOST EXAMPLE. 

* 




* SYSTEM DEFINITION. 

* 




* SYSTEM INCLUDES: 
it 




* C CONSOLE 




* D DIAGNOSTICS 




* P PERFORMANCE 




* R REMOTE 

* 




* TIPS PRESENT ARE: 

it 




* A ASYNC 




* B BISYNC 2780-3780 




* H HASP 




* M M0DE4 




* XA X25 A TO A 


USERBPS 


* XP X25 PAD 

* 


Definitions 


* edef ghljkm 




SYS=C/D/P/R,TS=A/B/H/M/XA/XP. 




* VARIANT DEFINITIONS 
* 




* NPU A 




* a cbe ghjkm 




VRD-VNA,VT=C/L/P , SZ=128K,TS=A/B/M/XA/XP. 
* 




* NPU B 




* 




* b df g i j 




VRD-VNB,VT=D/L,SZ=128K,TS=A/H/M. 
* 




* 

* LOAD FILE DEFINITION 
* 




* n a b 




LFD=EX4 , LM-VNA/VNB . 
* 





Figure 5-8. USERBPS Definitions, NDL Source Input, LCF Source Input, 
and EQPDECK Entries for Example 3 (Sheet 1 of 5) 
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NCF2P2:NFILE. 








NPUA:NPU 


NODE=5, VARIANT 


a 
"VNA. 






SOPLINK 


LLNAME=LL35. 








SUPLINK LLNAME=LL45. 








COUP2 : 


COUPLER NODE =2, 


HNAME=fflOSTl, 


LOC 


'PRIMARY. 


LL23: 


LOGLINK NCNAME 


=COUP3. 






LL24: 


LOGLINK NCNAME =COUP4. 






LL25: 


LOGLINK NCNAME 


=NPUA. 






LL26: 


LOGLINK NCNAME 


=NPUB. 






COUP3: 


COUPLER NODE=3, 


HNAME=HOST2, 


LOC' 


=SECOND. 


LL34: 


LOGLINK NCNAME =COUP4. 






LL35: 


LOGLINK NCNAME 


=NPUA. 






LL36: 


LOGLINK NCNAME 


=NPUB. 







I 
I 



b NDL 

NPUB:NPU N0DE=6, VARIANT-VNB. Source | 

SUPLINK LLNAME=LL46. I nput I 

SUPLINK LLNAME=LL36. 

COUP4: COUPLER NODE =4, HNAME=*OST3. | 

LL45: LOGLINK NCNAME=NPUA. | 

LL46: LOGLINK NCNAME=*NPUB. 

TRUNK56: TRUNK N1=NPUA, N2=NPUB, Pl-1, P2-1. 

END. 



EQ41=NP,ST=ON,EQ=7,PI=l,CH-5,ND=2,SA=OFF. COUPLER 2 FOR HOST 1 
EQ42=NP,ST=ON,EQ^7,PI=l,CH=5,ND=3,SA=OFF. COUPLER 3 FOR HOST 2 
EQ42=NP,ST=ON,EQ=7,PI=-l,CH=5,ND=4,SA=OFF. COUPLER 4 FOR HOST 3 



Figure 5-8. USERBPS Definitions, NDL Source Input, LCF Source Input 
and EQPDECK Entries for Example 3 (Sheet 2 of 5) 
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LCFFILE:LFILE. 

TITLE LCF FOR HOST 1 



** 

* APPLICATION DEFINITIONS FOR HOST 1 
** 



IAF :APPL,PRIV. 

RBF :APPL,PRIV,DID,PRU. 

QTF :APPL,PRU,NETXFR,PRIV. 

QTFS :APPL,MXCOPYS=10,RS,PRU,NETXFR,PRIV. 

PTF :APPL,MXCOPYS=6,PRU,NETXFR,PRIV. 

PTFS :APPL,MXCOFYS=10,RS,NETXFR,PRIV. 



* 

* INCALL/OUTCALL BLOCKS FOR HOST 1 

** 

INCALL ,FAM=0 ,UNAME=NETOPS ,ANAME=QTFS ,DBL=7 ,ABL=7 ,DBZ=1000 . 
OUTCALL, NAME 1=QTFS ,PID=M02 , SNODE=2 ,DNODE=3 ,DBL=7 , ABL=7 ,DBZ=1000 . 
OUTCALL .NAME 1=QTFS ,PID=M03 , SNODE=2 ,DNODE=4 ,DBL=7 ,ABL=7 ,DBZ=1000 . 
INCALL ,FAM=0 ,UNAME=NETOPS ,ANAME=PTFS ,DBL=7 , ABL=7 ,DBZ=1000 . 
OUTCALL ,NAME1=PTFS ,PID=M02 , SN0DE=2 ,DNODE=3 ,DBL=7 ,ABL=7 ,DBZ=1000 . 
OOTCALL,NAME1=PTFS,PID=M03,SNODE=2 J DNODE=4,DBL=7,ABL=7,DBZ=1000. 



Figure 5-8. USERBPS Definitions, NDL Source Input, LCF Source Input 
and EQPDECK Entries for Example 3 (Sheet 3 of 5) 
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LCFFILE:LFILE. 

TITLE LCFFILE FOR HOST 2 



** 

* APPLICATION DEFINITIONS FOR HOST 2 
** 



IAF :APPL,PRIV. 

RBF : APPL , PRIV , UID , PRU . 

QTF :APPL, PRO, NETXFR, PRIV. 

QTFS :APPL ,MXCOPYS= 10 , RS ,PRU , NETXFR , PRIV . 

PTF :APPL,MXCOPYS=6, PRU, NETXFR, PRIV. 

PTFS : APPL ,MXCOPYS= 10 , RS ,PRU , NETXFRV , PRIV . 



* INCALL/OUTCALL BLOCKS FOR HOST 2 

* 
** 



INCALL ,FAM=0,UNAME=NETOPS ,ANAME=QTFS ,DBL=7 ,ABL=7 ,DBZ=1000 . 
0UTCALL,NAME1=QTFS ,PID=M01 , SNODE=3,DNODE=2,DBL=7 , ABL=7 ,DBZ=1000 . 
OUTCALL,NAMEl=QTFS,PID=MO3,SN0DE=3,DNODE=4,DBL=7,ABL=7,DBZ=1000. 
INCALL , FAM=0 , UNAME=NETOPS .ANAME-PTFS , DBL=7 , ABL=7 ,DBZ= 1000 . 
OUTCALL ,NAME1=PTFS ,PID=M01 , SNODE=3 ,DNODE=2 , DBL=7 , ABL=7 ,DBZ=1000 . 
OUTCALL , NAME 1 =PTFS , PID=M03 , SNODE=3, DNODE=4 , DBL=7 , ABL=7 , DBZ= 1 000 . 



Figure 5-8. USERBPS Definitions, NDL Source Input, LCF Source Input 
and EQPDECK Entries for Example 3 (Sheet 4 of 5) 
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LCFFFILE:LFILE 

TITLE LCFFILE FOR HOST 3 



** 

* APPLICATION DEFINITIONS FOR HOST 3 
** 



IAF :APPL,PRIV. 

RBF :APPL,PRIV,UID,PRU. 

ITF :APPL,PRIV. 

QTF :APPL,PRU,NETXFR,PRIV. 

QTFS : APPL .MXCOPY S= 10 , RS , PRU , NETXFR * PRIV . 

PTF :APPL,MXC0PYS=6, PRU, NETXFR, PRIV. 

PTFS :APPL,MXCOPYS=10,RS, PRU, NETXFR, PRIV. 



* 

* INCALL/OUTCALL BLOCKS FOR HOST 3 

* 

** 



INCALL ,FAM=0 ,UNAME=NETOPS ,ANAME=QTFS ,DBL=2 , ABL=2 ,DBZ=1000 . 
OUTCALL , NAME 1 =QTFS , P ID=M02 , SN0DE=4 , DN0DE=3 , DBL=2 , ABL=2 , DBZ= 1000 . 
0UTCALL,NAME1=QTFS ,PID=M01 ,SNODE=4,DNODE=2,DBL=2,ABL=2,DBZ=1000 . 
INCALL ,FAM=0 , UNAME=NETOPS , ANAME=PTFS ,DBL=2 , ABL=2 ,DBZ=1000 . 
OUTCALL, NAME1=PTFS,PID=M02,SNODE=4,DNODE=3,DBL=2,ABL=2,DBZ=1000. 
OUTCALL ,NAME1=PTFS , PID=M01 , SN0DE=4 , DNODE=2 ,DBL=2 , ABL=2 ,DBZ=1000 . 



Figure 5-8. USERBPS Definitions, NDL Source Input, LCF Source Input 
and EQPDECK Entries for Example 3 (Sheet 5 of 5) 
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Example 4: Three Hosts, Two NPUs, X25 Line 

Figure 5-9 illustrates the configuration of the network for this example. It shows the size 
of each NPU, the external connections (trunks and couplers) to each NPU, and the interface 
programs (TIPs, HIP, and LIP) included in each NPU. It also shows the node number and port 
assignments and/or NDL names for major components in the network as chosen for this 
example. This configuration resembles that of example 3 except that the two NPUs are 
connected by an X25 line instead of a LIP trunk. In the configuration shown in figure 5-9, 
the following conditions apply: 

NPUA has four TIPs, a HIP, and an X25 line. The latter two programs are required 
for the coupler and trunk respectively. 

NPUB has three TIPs and an X25 line. 

H0ST1 has NS only. 

H0ST2 has CS only. 

H0ST3 has NS and CS. 

PTF and QTF are installed on all three hosts. 

NPUA has the performance statistics package and console support. NPUB has online 
diagnostics. NPUA and NPUB can communicate with all three hosts in the network. 

The following procedure illustrates the installation of CCP with a network configuration as 
shown in figure 5-9. 

1. Ensure that the required files and tapes are available. Refer to figure 5-10 for 
the appropriate USERBPS definitions, EQPDECK entries, and NDL source input. 

2. Follow steps 2 through 6 in example 2. 

3. Create the load file used by NAM/NS to downline load the NPUs. 

n 
BEGIN , CCPLOAD , INSTALL , GN=EX4 . 

The load file name is GEX4. 

4. Execute this build step only if you want to purge extraneous files. 

a b 
BEGIN , CCPPURG , INSTALL , VI =VNA, V2 =VNB. 

This step purges all extraneous permanent files associated with variant names VNA 
and VNB. 
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Figure 5-9. Network Configuration - Example 4 
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* 


USERBPS 






* 

+ 


TWO-NPU 


, THREE^IOST EXAMPLE. 




* 


SYSTEM 


DEFINITION. 




* 

* 


SYSTEM 


INCLUDES: 




* 
* 
* 

* 
•*• 


C 
D 
P 
R 


CONSOLE 
DIAGNOSTICS 
PERFORMANCE 
REMOTE 




* 


TIPS PRESENT ARE: 




* 
* 
* 

* 
* 
* 
* 


A 

B 

H 

M 

XA 

XP 


ASYNC 

BISYNC 2780-3780 

HASP 

MODE4 

X25 A TO A 

X25 PAD 


USERBPS 
Definitions 



* edef ghijk m 
SYS =C /D /P_/R , TS =A /B_/H /M /XA /XP . 
* 

* VARIANT DEFINITIONS 

* 

* NPU A 
* 

* a cbe ghjkm 
*VRD=VNA,VT=C/F/P.SZ»128K.TS'°A/B/M/XA/XP. 
* 

* NPU B 
* 

* b df gijk 
*VRD=VNB,VT=D/F, SZ=1 28K,TS=A/H/M/XA. 
* 

* 

* LOAD FILE DEFINITION 
* 

* n a b 
LFD=EX4 , LM=VNA/VNB . 



Figure 5-10. USERBPS Definitions, NDL Source Input, LCF Source Input, 
and EQPDECK Entries for Example 4 (Sheet 1 of 5) 
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NCF2P2:NFILE. 

a 
NPUA:NPU N0DE=5, VARIANT=VNA. 
SUPLINK LLNAME=LL35. 
SUPLINK LLNAME=LL45. 
C0UP2: COUPLER NODE=2, HNAME=HOSTl. 
LL23: LOGLINK NCNAME=COUP3. 
LL25: LOGLINK NCNAME=NPUA. 
COUP3: COUPLER NODE=3, HNAME=HOST2. 
LL32: LOGLINK NCNAME=COUP2 . 
LL35: LOGLINK NCNAME=NPUA. 
L08 :LINE PORT=8 LTYPE=H1 , 
TIPTYPE=X25 ,DFL=1 28 , 
FRAME=7,RTIME=30OO,RCOUNT=15, 
PSN=TYMNET , NS V C= 1 6 , DCE . 
T08 :TERMDEV W=2,NCIR=16, 
NEN=16,STIP=X25. 

b NDL 

NPUB:NPU NODE=6, VARIANT-VNB. Source 

SUPLINK LLNAME=LL46. Input 

SUPLINK LLNAME=LL36. 

COUP4: COUPLER NODE=4, HNAME=HOST3. 
LL46: LOGLINK NCNAME=NPUB. 
L09 :LINE PORT=9,LTYPE=Hl , 
TIPTYPE=X25 ,DFL=1 28 , 
FRAME=7 ,RTIME=3000 , 
RCOUNT=l 5 , PSN=TYMNET , 
NSVC=16. 
T09 :TERMDEV W=2,NCIR=16, 
NEN=16,STIP=X25. 

END. 



EQ41=NP,ST=ON,EQ=7,PI=l,CH=5,ND=2,SA=OFF. COUPLER 2 FOR HOST 1 
EQ42=NP,ST=ON,EQ=7,PI=l,CH=5,ND=3,SA=OFF. COUPLER 3 FOR HOST 2 
EQ42=NP,ST=ON,EQ=7,PI=l,CH=5,ND=4,SA=OFF. COUPLER 4 FOR HOST 3 



Figure 5-10. USERBPS Definitions, NDL Source Input, LCF Source Input 
and EQPDECK Entries for Example 4 (Sheet 2 of 5) 
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LCFFILErLFILE. 

TITLE LCF FOR HOST 1 



** 
* 

* APPLICATION DEFINITIONS FOR HOST 1 

* 
** 



IAF :APPL,PRIV. 

RBF :APPL,PRIV,UID. 

ITF :APPL,PRIV. 

QTF :APPL,PRU,NETXFR,PRIV. 

QTFS :APPL,MXCOPYS=10,RS,PRU,NETXFR,PRIV. 

PTF :APPL,MXCOPYS=6,PRU,NETXFR,PRIV. 

PTFS :APPL,MXCOPYS=10,RS,NETXFR,PRIV. 

** 

* INCALL /OUTCALL BLOCKS FOR HOST 1 
* 

** 

INCALL , FAM=0 , l)NAME=NETOPS ,ANAME=QTFS , DBL»7 , ABL-7 , DBZ=lO0O . 

OUTCALL, NAME1 =QTFS ,PID=M02, SNODE=2,DNODE= 3 ,DBL=7 , ABL=7 ,DBZ=1000 . 

INCALL ,FAM=0 ,UNAME=NETOPS ,ANAME=PTFS ,DBL=7 ,ABL=7 ,DBZ=1000 . 

OUTCALL ,NAME1=PTFS ,PID=M02 , SNODE=2 ,DNODE=3 ,DBL=7 , ABL=7 ,DBZ=1000 . 

INCALL ,FAM=0,UNAME=NETOPS ,ANAME=QTFS ,PORT=8 , SNODE=5 ,DNODE=2 ,DBZ=1000 ,DBL=7 ,ABL=7 , 

UBZ=1000,UBL=7 ,WS=7,DPLS=1024. 
OUTCALL ,NAME1=QTFS ,PID=M03 , SNODE=2 ,DNODE=5 , SHOST=2D3033 ,PORT=8 , DHOST=4 , DBZ=lO0O ,DBL=7 ,ABL=7 , 

UBZ=1000,UBL=7 ,WS=7,DPLS=1024. 
INCALL ,FAM=0 ,UNAME=NETOPS ,ANAME=PTFS , PORT=8 , SNODE=5 ,DNODE=2 , DBZ=lO0O ,DBL=7 ,ABL=7 , 

UBZ-10O0,UBL=7,WS=7,DPLS=1024. 
OUTCALL ,NAME1=PTFS ,PID=M03 , SN0DE=Z, DNODE=5 , SHOST=2D3033 ,PORT=8 ,DHOST=4,DBZ=1000 ,DBL=7 ,ABL=7 , 

UBZ=1000,UBL=7 ,WS=7,DPLS=1024. 



Figure 5-10. USERBPS Definitions, NDL Source Input, LCF Source Input 
and EQPDECK Entries for Example 4 (Sheet 3 of 5) 
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LCFFILE:LFILE. 

TITLE LCFFILE FOR HOST 2 



** 

* APPLICATION DEFINITIONS FOR HOST 2 
** 



IAF :APPL,PRIV. 

RBF : APPL , PRIV .UID . 

ITF : APPL, PRIV. 

QTF : APPL , PRU , NETXFR , PRI V . 

QTFS :APPL,MXCOPYS=10,RS, PRU, NETXFR, PRIV . 

PTF : APPL .MXCOPYS-6 , PRU , NETXFR , PRIV . 

PTFS :APPL,MXCOPYS=10,RS, PRU, NETXFR, PRIV. 

** 

* INCALL/OUTCALL BLOCKS FOR HOST 2 



** 



INCALL ,FAM=0 ,UNAME=NETOPS , ANAME=QTFS ,DBL=7 , ABL=7 ,DBZ= 1000 . 

OUTCALL, NAME1=QTFS ,PID=M01 ,SNODE=3 ,DNODE=2 ,DBL=7 ,ABL=7,DBZ=1000. 

INCALL, FAM=0 ,UNAME=NETOPS , ANAME=PTFS ,DBL=7 ,ABL=7 ,DBZ=1000 . 

0UTCALL,NAME1=PTFS ,PID=M01 ,SNODE=3,DNODE=2 ,DBL=7 ,ABL=7 ,DBZ=1000. 

INCALL ,FAM=0 ,UNAME=NETOPS ,ANAME=QTFS ,P0RT=8 , SNODE=5 ,DNODE=3 ,DBZ= 1000 ,DBL=7 , ABL=7 , 

UBZ=1000,UBL=7 ,WS=7 ,DPLS=1024 . 
OUTCALL ,NAME1=QTFS ,PID=M03 ,SNODE=3 ,DNODE=5 ,SHOST=2D3033 ,PORT=8 ,DHOST=4,DBZ=1000 ,DBL=7 ,ABL=7 , 

UBZ=1000 ,UBL=7 ,WS=7 ,DPLS=1024 . 
INCALL ,FAM=0 ,UNAME=NETOPS ,ANAME=PTFS ,P0RT=8, SN0DE=5 ,DN0DE=3 ,DBZ=1000 ,DBL=7 , ABL=7 , 

UBZ=1000,UBL=7,WS=7,DPLS=1024. 
OUTCALL , NAME 1=PTFS ,PID=M03 , SNODE=3 ,DNODE=5 , SHOST=2D3033 ,PORT=8 , DHOST=4 ,DBZ=1000 , DBL=7 , ABL=7 , 

UBZ=1000,UBL=7,WS=7,DPLS=1024. 

Figure 5-10. USERBPS Definitions, NDL Source Input, LCF Source Input 
and EQPDECK Entries for Example 4 (Sheet 4 of 5) 
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LCFFFILE:LFILE 

TITLE LCFFILE FOR HOST 3 



** 

* 

* APPLICATION DEFINITIONS FOR HOST 3 

** 



IAF :APPL,PRIV. 

RBF :APPL,UID,PRIV. 

ITF :APPL,PRIV. 

QTF :APPL,PRU,NETXFR,PRIV. 

QTFS :APPL,MXCOPYS=10,RS,PRU,NETXFR,PRIV. 

PTF :APPL,MXCOPYS=6,PRU,NETXF2,PRIV. 

PTFS :APPL , MXCOPYS=10 , RS , PRD, NETXFR, PRIV. 



* INCALL/OUTCALL BLOCKS FOR HOST 3 

** 



INCALL , FAM=0 , UNAME=NETOPS , ANAME=QTFS , PORT=9 , SNODE=6 ,DNODE=4 , DBZ=1000 , DBL=7 , ABL=7 
UBZ=1000,UBL=7,WS=7,DPLS=1024. 

OUTCALL ,NAME1=QTFS ,PID=M01, SNODE=4,DNODE=6 ,SHOST=2D3031 ,PORT=9 ,DHOST=2 ,DBZ=1000 ,DBL=7 ,ABL=7 
UBZ=1000,UBL=7,WS=7,DPLS=1024. 

INCALL , FAM=0 , UNAME=NETOPS , ANAME=PTFS , PORT=9 , SNODE=6 , DNODE=4 , DBZ=1000 , DBL=7 , ABL=7 , 

UBZ= 1000, UBL=7,WS=7,DPLS= 1024. 
OUTCALL ,NAME1=PTFS ,PID=M01 , SNODE=4, DNODE=6 , SHOST=2D3031 , P0RT=9 ,DH0ST=Z, DBZ=1000 ,DBL=7 , ABL=7 

UBZ=1000,UBL=7,WS=7,DPLS=1024. 
OUTCALL , NAME 1=QTF3,PID=M02, SN0DE=4,DNODE=6 , SHOST=2D3032 ,PORT=9 ,DHOST=3 ,DBZ=1000,DBL=7 ,ABL=7 

UBZ=1000,UBL=7,WS=7,DPLS=1024. 

OUTCALL, NAMEl=PTFS,PID=MO2,SNODE=4,DNODE=6,SHOST=2D3032,PORT=9,DHOST=3,DBZ=10O0,DBL=7,ABL=7 
UBZ=1000,UBL=7,WS=7,DPLS=1024. 



Figure 5-10. USERBPS Definitions, NDL Source Input, LCF Source Input 
and EQPDECK Entries for Example 4 (Sheet 5 of 5) 
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CDCS2 - CYBER DATABASE CONTROL SYSTEM VERSION 2 

This subsection describes these installation options for CDCS2: 

• Unique Parameters 
I • CDC Procedure File 

• Special Notes 

• Accounting Table 

• Verification 

UNIQUE PARAMETERS 

SRT4 To assemble code to interface with Sort/Merge 4 rather than Sort/Merge 5, 
specify the keyword SRT4 on the call to CDCS 2. 

DEBUG To activate commands that generate CDCS flow points, specify the keyword DEBUG 
on the call to CDCS2. These flow points trace the execution of CDCS modules 
from initialization to termination. Generation of the flow points increases the 
execution size of CDCS by approximately 2500g words. 

For more information on activating the interface between CDCS2 and C0B0L5, refer to C0B0L5 
in this section. 
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CDC PROCEDURE FILE I 

Refer to the beginning of this section for information about the CDC startup procedure I 
file. Refer to the CYBER Database Control System 2 Reference Manual for instructions on 
constructing the procedure file. 



SPECIAL NOTES 



• 



CDCS 2 users must have permission to use the system control point facility (refer to 
the description of MODVAL in the NOS 2 Administration Handbook). 

To activate a debug trace facility for CDCS 2, specify the E parameter on the SYMPL 
commands in the CDCS2 installation procedure. 



ACCOUNTING TABLE 

The CDCS routine DB$ACCT contains a table of average central processor (CP) and input/output 
CI/O) times, in microseconds, for CDCS user requests. These average values were obtained 
from simulation runs on a model 74 and adjusted based on actual runs performing file 
creation and updating on indexed sequential files with a record size of 40 words. 

When a user issues a CDCS request, such as open, read, or rewrite, CDCS retrieves the value 
from the appropriate table entry and accumulates it in the accounting accumulator for the 
individual user. CDCS accumulates the charged CP and I/O time for all users combined and 
prints it in the dayfile at the end of the CDCS session. The actual time used for the 
entire CDCS session is also printed in the dayfile. Because different environments produce 
different values for the average CP and I/O times required for each user request, CDCS 
provides options for the database administrator to modify these table values. 

One method of modification is specifying new values for the CP and I/O times on the command 
that initializes CDCS (refer to the CDCS 2 Data Administration Reference Manual). With this 
method, all the entries in the accounting table are multiplied by the ratio of the specified 
value to the table value for a random read on an indexed sequential file. 

A second method of modification is changing the values in the accounting table and 

installing CDCS with the recompiled table. You can modify any or all entries in the table. 

List the deck DBSACCT to see the current values in the accounting table. Entries in the 
table are in COMPASS macro format, as follows. 



60459320 E «... 

j-oj 



Field 1 (column 1) 
Field 2 (column 2) 



Blank or comma. 

One of the following user request codes. 



DFLOG 


Logging 


DFRD2 


Random Read 


DFRD1 


Sequential Read 


DFWR2 


Random Write 


DFSKF 


Skip 


DFREW 


Rewrite 


DFDEL 


Delete 


DFOPN 


Open 


DFCLS 


Close 


DFSTX 


Start on index file 


DFINV 


Invoke 


DFSTR 


Start 


DFEND 


End 


DFTER 


Abnormal termination 


DFRPT 


Recover point 


DFPVC 


Privacy 


DFLOK 


Lock 


DFULK. 


Unlock 


DFRSR 


Relation start 


DFDBS 


Database status block 


DFRX2 


Read random on index file 


DFRX1 


Read sequential on index file 


DFRWX 


Rewind index file 


DFRWF 


Rewind area file 


DFRWR 


Rewind relation 


DFVER 


Version change 


DFBEG 


Begin transaction 


DFCMT 


Commit transaction 


DFDRP 


Drop transaction 


DFASK 


Ask restart identifier 


DFGID 


Get restart identifier 



Field 3 (column 11) 
Field A (column 18) 



The macro identifier ACC. 

CP and I/O times required by each request. Parameters represent 
the different types of charges according to different file 
organizations, logging, and other factors. Possible parameters are 
as follows. 



AK AK primary key charge 

ALT Alternate key charge 

ARL Area logging flag 

DA DA primary key charge 

FIX Fix charges 

ISJLG Journal logging charge 

JNL Journal logging flag 

MOD Database modification flag 

QLG Quick recovery logging charge 

QRF Quick recovery logging flag 
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The following is an example of an entry in the table. 

DFRD2 ACC ( ( IS=4000 ,7000 ) , (DA=3500 ,6500 ) , (AK=3000 ,6000 ) , (ALT=3000 , 7000 ) ) 

This entry states that for a random read performed on (for example) an indexed sequential 
file, the CP charge is 4000 s, and the I/O charge is 7000 s. 

VERIFICATION 

To verify the installation of CDCS2, do the following: 

1. Run a job that executes the following command. 
BEGIN , VCDCS2A , INSTALL , S=INSTALL . 

This job creates the permanent files SSIO and MSTRDIR on the installation user name 
INSTALL. These files are required for CDCS2 operation during verification. 

2. Enter the following DSD commands at the system console. 

SUBSYST. 

L. ENABLE, CDC, n. 

L.END 

CDC. 

n is the control point. 

3. Run a job that executes the following command. 
BEGIN , VCDCS2B , INSTALL . 

This job creates the permanent file I0AREAB. If this job is successful, CDCS2 
verification is complete. 

4. Access the K display with the following DSD command. 
K.CDC. 

5. Enter the following command to terminate CDCS2. 
K.TERM. 
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CID - CYBER INTERACTIVE DEBUG VERSION 1 



The following installation parameters define the size of various tables used by CID. 
Certain table sizes are defined by parameters in both SYMFL and COMPASS decks. If you alter 
such a table size, change all installation parameters defining the table size. Compile or 
assemble the indicated Update deck(s) to obtain sequence information. 



Parameter 



Default 



BREAKTABSIZE 
TABSIZE 


16 
16 


GROUPTABSIZE 
TABSIZE 


16 
16 


TRAPTABSIZE 
TRAPXSIZE 


16 
19 


TABSIZE 
XSIZE 


16 
19 



Significance 

Number of entries in breakpoint table. 

Parameters are located in common decks BREAKD (SYMPL) and 

BREAKZ (COMPASS). 

Number of entries in group table. 

Parameters are located in common decks GROUPD (SYMPL) and 

GROUPZ (COMPASS). 

Number of entries in trap table. 

TRAPXSIZE and XSIZE must each be three 

greater than the table size defined by 

TRAPTABSIZE and TABSIZE. Parameters are located in common 

decks TRAPD (SYMPL) and TRAPZ (COMPASS). 



R00M54 



10B 



Number of words available for EACPM loader table (54 table) 
expansion before CID must recreate its overlays at debug 
time. Parameter is located in deck D'BUGI. 
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COBOL5 AND COBOL5Q - COBOL VERSION 5 

This subsection describes the following installation options for C0B0L5: 

• C0B0L5 and C0B0L5Q Installation Procedures 

• Unique Parameters 

• Installation Parameters 

INSTALLATION PROCEDURES 

COBOL Version 5 has two methods of customized installation: the full mode installation, 
which assembles and compiles all compiler and object library routines, and the Q mode 
installation (deck C0B0L5Q). 

Q mode installation allows you to modify only those routines affected by corrective code 
and/or user code (for example, activating Data Management) and local code (for example, 
default page size, CMU, and so forth), and to produce a new file through the COPYL utility, 
using the changed routines and a previous release level of C0B0L5 as input. You must 
provide *COMPILE directives on file USER for any affected routine. 

UNIQUE PARAMETERS 

NOCDCS To deactivate the interface between C0B0L5 and CDCS2, specify the keyword NOCDCS 
on the call that executes the installation procedure for C0B0L5. 

SRT4 To assemble code to interface with Sort/Merge 4 rather than Sort/Merge 5, 
specify the keyword SRT4 on the call for C0B0L5. 

TAF To activate the interface between C0B0L5 and TAF, specify TAF on the call which 
executes the installation procedure for COBOLS. 
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INSTALLATION PARAMETERS 

The C0BOL5 compiler uses IPTEXT symbol definitions, which are filtered through CB5TEXT. No 
direct references to any IPTEXT symbols are contained in the compiler or the object 
routines. This allows you more flexibility in changing normal installation parameters for 
C0B0L5. 

The system obtains symbols governing machine type, character set, and CMU option from 
IPTEXT. To override one or more system defaults, select the desired changes from the 
following list and put them on file USER for the C0B0L5 or C0B0L5Q installation procedure. 

• To change the default error termination level to T, W, F, or C, use 1, 2, 3, or 4, 
respectively, for level in the following statement. The DEF CB5$ET statement is in 
deck ASSEMOP. 

DEF CB5$ET#level#; 

• To change the default organization (xx) for actual key, direct access, or indexed 
(IS) files from version 2 (ORG=NEW) to version 1 (ORG=OLD), locate CB5$xxOLDNEW in 
deck ASSEMOP and change it to: 

DEF CB5$xxOLDNEW # OLD #; 

xx Description 

AK Actual key files. 

DA Direct access files. 

IS Indexed files. 
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DO. - DATA CATALOGUE VERSION 2 

This subsection describes product dependencies for DCL and SYSGEN functions for DCL. 

PRODUCT DEPENDENCIES 

The C0B0L5 compiler and library must be available for the installation of DCL. The product 
must run from permanent files. 

SYSGEN FUNCTIONS 

SYSGEN(FULL) installs all files for DCL on user name LIBRARY. If you customize the DCL 
files, install the modified files by executing these steps: 

1. Before running the DCL2 build procedure, execute these commands on your installation I 
user name: | 

PURGE (PFGDCL2) 
DEFINE (PFGDCL2 /CT=S ) 
RETURN(PFGDCL2) 

2. Run the DCL2 build procedure. Then enter these commands at the system console: I 

X.DIS. 

USER(INSTALL, INSTALL) . 

ATTACH(PFGDCL2) { 

SYSGEN(DCL2) 
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FDBF - FORTRAN DATABASE FACILITY VERSION 1 

This subsection describes product dependencies for FDBF and unique parameters for FDBF. 

PRODUCT DEPENDENCIES 

The installation tool SYNGEN, which resides on the DDL 3 program library, must be available 
for the installation of FORTRAN Data Base Facility (FDBF) 1. 



UNIQUE PARAMETERS 

FTN4 To specify that FORTRAN 4 is the default language rather than FORTRAN 5, specify 
the keyword FTN4 on the call to FDBF. 
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FSE - FULL SCREEN EDITOR 

This subsection describes the following: 
FSEEX and SMFEX Implementations 
SMF Procedure File 
Installation Parameters 
SYSGEN Functions for FSE 
SMFSTAT Procedure 

FSEEX AND SMFEX IMPLEMENTATIONS 

There are two implementations for the FSE: FSEEX AND SMFEX. The FSEEX program is a complete 
implementation of the editor and is called by the user with entry point FSE. The SMFEX 
program is a NOS subsystem, called by the operator, which implements a subset of the editor 
with performance characteristics different from FSEEX. 

When the SMFEX subsystem is enabled, the operating system automatically processes a large 
portion of the user's FSE calls through SMFEX. When SMFEX is disabled, the FSEEX program is 
automatically scheduled with compatible external features. Where the NOS scheduler would 
process the FSEEX field length of approximately 50000g words, the SMFEX scheduler 
processes approximately 3000g words. SMFEX can process editing transactions most 
effectively if the hardware configuration provides extended memory in the amount of 3000g 
words per editing user. Extended memory can be ECS, ESM, LCM, or UEM. SMF can function 
without adequate extended memory, but it functions less efficiently. When SMFEX is 
operating, it uses a dedicated control point with a central memory (CM) field length 
typically ranging from 54000g to 700Q0g words. If the configuration provides user 
access to extended memory, SMFEX also uses a dedicated extended field length whose size is 
as much extended memory as is available, up to a limit determined by installation parameter 
NUMSWPECS. 

In summary, the decision to enable or disable SMFEX is a tradeoff, where stand-alone FSEEX 
uses a large resource per user, while combined FSEEX plus SMFEX uses a large fixed resource 
with a small incremental resource for each user. 

SMFEX is likely to improve overall performance if the hardware configuration provides at 
least 51 2K words of memory, including some form of extended memory, and if the workload 
includes at least 40 users simultaneously calling FSE. SMFEX is likely to degrade overall 
performance if the configuration provides 131K or smaller central memory, or if fewer than 
20 users call FSE simultaneously. 

For configurations of 262K central memory and 20 to 40 editor users, SMFEX can be expected 
to improve response times for those users who call the editor, but can either improve or 
degrade overall system performance. To evaluate the value of SMFEX, it is suggested that 
medium-size sites experiment by operating SMFEX on alternate days. 
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SMF PROCEDURE FILE 

Refer to the beginning of this section for information about the SMF subsystem initiation. 

Minimally, a procedure file for initiating SMFffff must include the following: 

.PROC, SMFffff. 
SMFEX. 

1 DMB. 

SMFEX, RECOVER. 
SKIP, EXIT. 

2 EXIT. 
DMB. 
DMD. 
DMD.3777777. 

3 SMFEX, RECOVER. 
ENDIF.EXIT. 

The sequence of DMB, EXIT, and SMFEX, RECOVER commands (numbered 1,2, and 3) is mandatory 
for valid subsystem shutdown and abort processing. 

The first SMFEX statement may be modified to be of the form: 

SMFEX, n. 

n is an integer from 2 to 8. This parameter determines the number of functions that can 
execute in parallel. The default is 3. Values of 3 or 4 are advisable for most sites. A 
guideline for selecting the value of n is one unit for every 25 users who simultaneously 
call FSE. Each increment in the value of n increases the central memory field length by 
approximately 4000g words. 

The SMFffff procedure can control the amount of extended memory allocated, by preceding the 
first SMFEX statement with: 

MFL,EC=m. 

m is the extended memory field length in units of 1000s words. 

Because SMFEX uses constant field lengths once it is fully initialized, it is advisable to 
select a control point number for the ENABLE command, which is either low or high. SMF then 
resides at one end of central memory, and has minimal effect on the storage move 
characteristics of the NOS job scheduler. 
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INSTALLATION PARAMETERS 

The following parameters are defined in deck COMFSMF. 



Parameter 



NUMSMFUSR 



Default 



100 



Significance 

Maximum number of users that can be processed by SMFEX. 
NUMSMFUSR need not equal the maximum number of users who call 
FSE, since FSEEX is processed by the NOS scheduler when SMFEX 
overflows. If this parameter is increased beyond 100, the 
entire operating system must be reassembled with MXLF (in deck 
PPCOM) redefined, so that SMFEX can allocate additional 
negative field length for local FNT entries. NUMSMFUSR cannot 
be increased beyond 500. 



NUMSWPECS 



100 



Maximum number of users that can be processed using extended 
memory. The extended field length is approximately 3000g 
words per user. This field length can be reduced at subsystem 
initiation by providing less extended memory or no extended 
memory in the EQPDECK. NUMSWPECS should not exceed NUMSMFUSR, 
and need not equal NUMSMFUSR since SMFEX will use mass storage 
devices for overflow. 



SYSGEN FUNCTIONS FOR FSE 

FSE is released with four files: FSEHELP, FSTEACH, FSEPROC, and SMFSTAT. The first three 
files are automatically stored under user name LIBRARY; SMFSTAT is stored under the 
installation user name INSTALL. 
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SMFSTAT PROCEDURE 

FSE installation creates an indirect access permanent file on the installation user name 
which contains a procedure called SMFSTAT. This procedure provides some statistics for the 
Multiuser Full Screen Editor (SMF). 

The SMF subsystem must be executing for SMFSTAT to run successfully. To use the SMFSTAT 
procedure, do the following: 

1. Log in to IAF under the user name where SMFSTAT is stored. 

2. Enter this command: 

BEGIN,, SMFSTAT. 

FSE comes up, and you can then enter the GET DATA (GD) directive. If the editor is 
not executing, or if the SMFSTAT procedure is executed in a noninteractive job, this 
directive has no effect. Otherwise, the GD directive obtains some statistic words 
from the editor's field length. Enter the QUIT (Q) directive to terminate this edit 
session. This starts up a FORTRAN program to analyze the results of the statistics 
obtained from the GD directive. The program displays a preliminary report on the 
screen, and provides a more detailed report on a local file called STATOUT. 

3. Either route the STATOUT report to the printer, or view it using FSE. 
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FTN4, FTNTS, AND FTN5 - FORTRAN EXTENDED VERSION 4, FORTRAN EXTENDED 
VERSION 4 WITH INTERACTIVE OPTION, AND FORTRAN 5 ' KAN EXTENDED 

This subsection describes the following: 

• MODEL Parameter 

• Installation Parameters for FTN4 and FTNTS 

• Installation Parameters for FTN5 

• Integer Multiply FCOs 

MODEL PARAMETER 

FTN4, FTNTS , and FTN5 reference the MODEL parameter (refer to TEXT and TEXTIO procedures in 
this section). Whether a computer efficiently executes the FORTRAN object code that it 
produced depends upon the model of the computer and the value specified in the MODEL 
parameter. If the value specified in the MODEL parameter is identical to the computer's 
model number the object code executes efficiently. If the value specified in the MODEL 
parameter is dxfferent from the computer's model number, the object code executes 
meffxciently or not at all (refer to table 5-5). 

INSTALLATION PARAMETERS FOR FTN4 AND FTNTS 

Depending on the installation parameters of interest, you can obtain a listing of the 

F?noL e L S n^,r Semb i i ^ F J NMAC ° r FTNTEXT <the FTNMAC 11Stin * iS much shorte ^ «*/<« FTN. 
™««i * „ ? ™ 8 ^ latlon P aramters ^r the default command settings, command error 
LduL ™^ ■« ??i ^ nameS ' ln P ut/out P ut buff « l^gth, overlay library names, and 
FT^Ic/fSteS) ^ lnCrements - ^ remaining parameters are in OPTIONS (called by 



^0459320 E _ 



INSTALLATION PARAMETERS FOR FTN5 

Depending on the installation parameters of interest, you can obtain the parameters by 
assembling FTN5TEXT and FTN. FTN contains the installation parameters for default command 
settings, command error processing, default file names, input/output buffer length, and 
compiler overlay library names. The remaining parameters are in OPTIONS (called by 
FTN5TEXT) . 

Reinstall the compiler and CCG whenever you change parameters in OPTIONS . You can revise 
installation parameters in COMFCIP (called by FTN and INITOO) during the installation of 
FTN5, if you reassemble both FTN and INITOO. 

INTEGER MULTIPLY FCOS 

Because all code generated by the compiler assumes the existence of the integer multiply 
hardware option, you must install all applicable integer multiply FCOs. 
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Table 5-5. MODEL Parameter and FTN4, FTNTS, and FTN5 Object Code Execution 



Value of MODEL 
Parameter in TEXT 
and TEXTIO 



Models on which 
Object Code Executes 
Inefficiently 



Models on which 

Object Code 
Does Not Execute 



71, 72, 73, 171, 172, 
173, 174, 720, 730 



74, 175 



740, 750, 760 



810, 815, 825, 830, 
835, 845, 855 



865, 875 



176 



74, 175, 740, 750, 760, 810 
815, 825, 830, 835, 840, 845, 
850, 855, 860, 865, 875 



71, 72, 73, 171, 172, 173, 
174, 720, 730, 740, 750, 
760, 810, 815, 825, 830, 
835, 840, 845, 850, 855, 860, 
865, 875 

71, 72, 73, 74, 171, 172, 173 
174, 175, 720, 730, 810, 
815, 825, 830, 835, 840, 845, 
850, 855, 860, 865, 875 

865 and 875. 

The following models apply as 
long as source code does not 
contain LEVEL 2 (direct access 
LCM) statements: 71, 72, 73, 
74, 171, 172, 173, 174, 175, 
720, 730,740, 750, 760. 

810, 815, 825, 830, 835, 840, 
845, 850, 855, and 860. 
The following models apply as 
long as source code does not 
contain LEVEL 2 (direct access 
LCM) statments: 71, 72, 73, 74, 
171, 172, 173, 174, 175, 720, 
730, 740, 750, 760. 

All models apply, except model 
176, as long as source code 
does not contain LEVEL 2 
(direct access LCM) statements. 



176 



176 



176 



176 
The following models apply 
if the source code contains 
LEVEL 2 statements: 71, 72, 
73, 74, 171, 172, 173, 174, 
175, 720, 730, 740, 750, 
760. 

176 

The following models apply 
if the source code contains 
LEVEL 2 statements: 71, 72, 
73, 74, 171, 172, 173, 174, 
175, 720, 730, 740, 750, 
760. 

All models apply except 
model 176, if the source 
code contains LEVEL 2 
statements. 
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IAF - INTERACTIVE FACILITY VERSION 1 

This subsection describes the following: 

• Installation Parameters 

• IAF Procedure File 

• Special Notes 



INSTALLATION PARAMETERS 

The following parameters, defined in deck IAFEX, specify default values for the Application 
Interface Program (AIP) Trace utility in IAF. 



Parameter 



DMCT 



MXML 



TJOB 



Default Significance 

16200 Maximum number of messages logged before the trace file is 
released to the system for processing. 

10 Maximum length in central memory words of a message logged on 

the trace file. 

TRACIAF Micro whose string specifies the name of the procedure file 
containing the job commands used to process the trace file. 



IAF PROCEDURE FILE 

Refer to the beginning of this section for information about the IAF procedure file and 
subsystem initiating. IAF initiation consists of these three procedures: IAF, IAFTM, and 
IAFTR. 

When IAFTM or IAFTR are used, they store a copy of TRACIAF under the system user index 
(377777s) for subsequent use. For additional information regarding the trace utility, 
refer to the NOS 2 Analysis Handbook. 



| NOTE 



The OPL deckname for the IAF procedure is IAFP. 
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SPECIAL NOTES 



Procedure file TRACIAF contains the commands to process the trace file. Modify 
procedure TRACIAF so that the USER and CHARGE commands have the appropriate 
parameters. The modifications can be placed on file USER. 

Two additional procedures exist to enable the console operator to select the type of 
trace, according to the parameter specified on the IAFEX command. In procedure 
IAFTM, T=* is the parameter on the IAFEX command; it causes the trace file to be 
processed only when IAF has terminated. In procedure IAFTR, T is the parameter on 
the IAFEX comand. The T parameter causes the trace file to be submitted as an input 
job using the TRACIAF file for the command record after every 16,200 messages have 
been logged on the trace file. Refer to NOS 2 Analysis Handbook for a description 
of the IAFEX command. 
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IMF1 - INFORMATION MANAGEMENT FACILITY VERSION 1 

This subsection describes product dependencies and unique parameters for IMF1. 

PRODUCT DEPENDENCIES 

The installation tool SYNGEN, which resides on the DDL 3 program library, must be available 
for the installation of IMF1. 

UNIQUE PARAMETERS 

SRT4 To assemble code to interface with Sort/Merge 4 rather than Sort/Merge 5, 
specify the keyword SRT4 on the call to IMF1. 
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ITF - INTERACTIVE TRANSFER FACILITY VERSION 1 

This subsection describes ITF, product dependencies for ITF, the ITF command, and ITF 
Shutdown and Idledown. 

ITF provides NOS interactive terminal users access to computer systems linked by a loosely 
coupled network (LCN) through the Remote Host Facility (RHF) subsystem. ITF multiplexes one 
or more network terminal connections through an application-to-application RHF connection to 
each remote host servicer application (ITFS). ITFS is provided only on the CYBER 200 VSOS 
operating system. 



PRODUCT DEPENDENCIES 

ITF serves as an application program to both the network access method (NAM) and RHF 
subsystems. ITF is initiated by NAMI using the NAM startup master file and remains 
connected to the NAM subsystem until either NAM is terminated or the NAM network operator 
commands IDLE or DISABLE are used. ITF remains connected to the RHF subsystem as long as 
there are interactive users connected to ITF. 

Before you execute the ITF installation procedure, the NAM5, RHC, and RHF installation 
procedures must complete successfully. The ITF installation procedure modifies the NAM 
startup master file which is created by the NAM5 procedure under the build user index. 
After all products that modify this file have been installed, you can use the SYSGEN(MOVE) 
command to move the startup master file to the proper user name (refer to File Placement 
under the NAM5 procedure description in this section). The released default JOBITF record 
which is added to the startup master file includes the following command to call ITF. 

ITF. 

If you want to add any optional parameters to the ITF command (see ITF command in this 
section), you can either use a text editor to modify the startup master file or add Update 
directives to the file USER for the ITF installation procedure. 

Before using ITF, you must ensure that the NDLP input for the NAM network configuration 
includes the following statement (refer to the Network Definition Language Version 1 
Reference Manual for a complete description of this statement). 

ITF: APPL.PRIV. 

You must also ensure that the RCFGEN input for the RHF network configuration correctly 
defines all NPID, PATH, and RNAD entries for all remote hosts and includes an APPL directive 
for ITF similar to the following (refer to Network Configuration Statements under the RHF 
procedure description in this section). 

APPL NAME=ITF,MXC0NS=2,MXC0PYS=1 

The value of the MXCONS parameter must not be less than the value of the PI parameter on the 
ITF command. 
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ITF COMMAND 

Here is the format for the ITF command: 

ITF(ML=ml,DL=dl,MA=ma,PI=pi,TE=te,CO=co) 

Parameter Significance 

ML=ml The mandatory logical Identifier (LID) for ITF connections. If ML=ml is 
omitted, each user is prompted to enter a LID. If specified, ITF 
automatically attempts to connect each user to the specified LID. ml 
must he defined in the CMR LID table. Default is no LID. 

DL=dl The default LID for ITF connections. If ML=ml is omitted, dl Is the 
default LID used by the system if the user does not enter a LID. dl 
must be defined in the CMR LID table. If DL=dl is omitted, ITF 
continues to request a LID from the user. Default is no LID. 

MA=ma The mandatory application to which users are switched when the 

connection terminates, ma must be 1 through 7 alphanumeric characters 
and can be the name of any NAM application installed In your system, or 
it may be an NVF command such as LOGOUT. If MA=ma is omitted, ITF 
prompts the user for another LID or application. If MA=LOGOUT is 
specified, users are logged out. Default is no application or command. 

PI=pi The maximum number of remote hosts to which ITF may simultaneously 

connect, pi can range from 1 through 7 and must be less than or equal 
to the value of the MXCONS parameter on the RHF configuration file APPL 
directive for ITF. Default is 2. 

TE=te The maximum number of interactive terminals that can connect to ITF. te 
can range from 1 through 128. Default is 128. 

CO=co The maximum number of terminals connected per remote host, co can range 
from 1 through 128. Default is 64. 

The PI, TE, and CO parameters are constrained by the definitions of symbols MAXACN (released 
| value = 2) and MAXTCN (released value - 64) in ITF common deck COMITBLS. The following 
relation exists: 

< PI ^ MAXACN 

< CO _< MAXTCN 

< TE <Mm (PI .MAXACN )*MIN (CO .MAXTCN) 
If any parameter is not specified or is not in range, it is set to the maximum allowed. 
The following space is allocated in common block COMITBLS at compile time: 

(2*MAXACN) + (MAXACN*maxtcn) words 

The space is allocated along with a variable number of buffers as needed to transfer data 
between the terminal and the remote host servicer. These tables and buffers are dynamically 
allocated and released under control of the Common Memory Manager. 
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ITF SHUTDOWN AND IDLEDOWN 

When ITF is connected to RHF, do not use the IDLE, RHF to shut down RHF. If the IDLE, RHF 
command is entered while ITF is connected to RHF (or if RHF terminates abnormally), ITF 
aborts and does not restart automatically. To restart the application, use the RS parameter 
on the NAM I command. 

Here are three ways to initiate an orderly shutdown of ITF: 

• RHF K Display command K.IDLE 

• K. DISABLE, n command 

If the K.IDLE command fails to terminate RHF within a reasonable time, check the RHF 
application display (K.APPL). If the active column shows that ITF is still 
connected, enter the K. DISABLE, n command to disable the ITF application ordinal. 

f DROP,jsn command 

If ITF remains connected after you have issued the K. DISABLE, n command, determine 
the jsn of the ITF job and use the DROP, jsn command to restart ITF. (The ITF jsn 
can be determined from the NAM status K-display.) 

Once ITF is no longer connected to RHF, you can use the IDLE or STOP commands to abort the 
subsystem. In general, you can use the DROP command to restart ITF. The default NAMI 
JOBITF record allows for a maximum of 10 restarts and saves ITF dump and trace files on 
permanent files for retrieval by COLLECT when NAM is next reinitiated. 

To temporarily disable ITF connections, use these commands: 
RHF APPL K. DISABLE, n 

and 
K. ENABLE, n 
To terminate ITF operation, use these commands: 
NAM NVF DISABLE ,AP=ITF 

and 
IDLE,AP=ITF 
To control access to particular LIDs and/or PIDs, use these commands: 
RHF PATH 

or 
ID K.DISABLE.n 

and 
K. ENABLE, n 
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LCS3 AND FCS3 - CONVERSION AIDS SYSTEM VERSION 3 

The Conversion Aids System includes the Language Conversion Aids System (LCS) and the File 
Conversion Aids System (FCS). This subsection describes USER file directives for LCS3. 



USER FILE DIRECTIVES FOR LCS3 

The tables of the FORTRAN and COBOL language conversion processors (LCPs) may overflow when 
programs with large numbers of symbols or with lengthy statements are processed. 

The FORTRAN LCP name table contains a fixed-size entry for each name that appears in a 
declarative statement. The COBOL LCP name table contains a variable-size entry for each 
special name, file name, and data name, except within either an RD entry in the Report 
Section or an SD entry in the File Section. COBOL name table entries are 4+(n+9)/10 words 
long (n is the number of characters in the name), with no rounding up. For example, if n=4, 
the name table entry is 5 words; if n=20, the name table entry is 6 words. 

You can enlarge these tables by including either of the following Update directives on file 
USER in the installation job for LCS. 

*DEFINE LTAB 
*DEFINE LTAB.XLTAB 

Table sizes and central memory requirements are shown in table 5-6. 



Table 5-6. Table Sizes and Central Memory Requirements 



No *DEFINE 
LCP Name Table 


(Default) 


*DEFINE LTAB 


*DEF1NE LTAB,XLTAB 


FORTRAN 








Table size 


300 entries 


600 entries 


- 


Minimum central 
memory required 


61000g words 


65000g words 


- 


COBOL 








Table size 


3200 words 


7000 words 


13000 words 


Minimum central 
memory required 


60000g words 


70000 8 words 


106000g words 



To create a special version of the LCS that includes the COPY processing logic and 
additional CRM routines, make the following Update directive available on file USER when the 
job to install the LCS is run. 

♦DEFINE CBLC0PY 
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The central memory requirements for this version of the LCS are increased by approximately 
20400 g words. 

To create a special version of the LCS that generates COBOL sequence numbers in increments 
of 1 (the default is 10), make the following Update directive available on file USER when 
the job to install the LCS is run. 

*DEFINE C0LUMN6 
The central memory requirements for this version are increased by 5 words. 
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LOADER - CYBER LOADER VERSION 1 

This subsection describes the unique parameters for the LOADER installation procedure and 
the installation parameters for LOADER. 



UNIQUE PARAMETERS 

PRESET The PRESET parameter sets the default central memory presetting options. 
The default value for the binaries you receive depends on the information 
you provided in the Order Information Package (OIP). The default for this 
procedure is zero. You can enter ZERO (same as 1), DEBUG (same as 11), or 
ONES (same as 2). You can also enter the values listed below. (Note that 
xx xxxx is the address of the preset location; yy yyyy is the result of 
adding 400000s and tne address of the preset location.) 



Value 



Preset (Octal) 






No presetting 


for ECS; 


same as 


1 for CM. 


1 


0000 


0000 


0000 


0000 


0000 


2 


7777 


7777 


7777 


7777 


7777 


3 


1777 


0000 


0000 


0000 


0000 


4 


3777 


0000 


0000 


0000 


0000 


5 


6000 


0000 


0000 


0000 


0000 


6 


4000 


0000 


0000 


OOxx 


xxxx 


7 


2525 


2525 


2525 


2525 


2525 


10 


5252 


5252 


5252 


5252 


5252 


11 


6000 


0000 


0004 


OOyy 


yyyy 



MAP 



This parameter sets the default LOADER MAP option. The default is OFF. 
You can enter the following values. 



Value 
OFF or 
PART or 3 
ON or 13B 

FULL or 17B 



Description 

Specifies MAP(OFF): no map. 

Specifies MAP(PART): statistics and block map. 

Specifies MAP(ON): statistics, block map, and entry 
point cross-references. 

Specifies MAP(FULL): statistics, block map, entry 
point map, and entry point cross-references. 
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FLMSG This parameter determines if LOADER issues a dayfile message indicating the 
field length required for loading and execution. Allowable values are YES 
(a dayfile message is issued) and NO (loader applies for relocatable loads 
when no map is specified). 



| NOTE 



Do not add code to set the symbols IP.PSET, 
IP.MAP, or IP. FLMSG, because these are set 
by the above parameters. 
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INSTALLATION PARAMETERS 

You can change the following parameters for LOADER. Insert the parameter 
changes at LDRC0M.13 in the update. 



Parameter 



IP.PSET 



Default 



IP.REW 



IP.LDER 



IP.FLINC 



4000B 



Significance 

Central memory presetting options. The default value for this 
parameter depends on the information you provided in the OIP. 
(Note that xx xxxx is the address of the preset location; yy 
yyyy is the result of adding 4000008 and tne address of the 
preset location.) 



Value 






Preset (Octal) 





No presetting 


for ECS; 


same as 


1 for CM. 


1 


0000 


0000 


0000 


0000 


0000 


2 


7777 


7777 


7777 


7777 


7777 


3 


1777 


0000 


0000 


0000 


0000 


4 


3777 


0000 


0000 


0000 


0000 


5 


6000 


0000 


0000 


0000 


0000 


6 


4000 


0000 


0000 


OOxx 


xxxx 


7 


2525 


2525 


2525 


2525 


2525 


10 


5252 


5252 


5252 


5252 


5252 


11 


6000 


0000 


0004 


OOyy 


yyyy 



Specifies whether file is rewound prior to beginning of load; 
one of the following values. 



Value 



Description 



1 File is rewound. 

File is not rewound. 
Error processing by the loader; one of the following values. 
Value Description 

Abort on all errors (ERR=ALL). 

1 Abort on fatal errors (ERR-FATAL) . 

2 No abort if abort is possible (ERR=N0NE). 

Amount of field length increase if additional field length is 
required for table construction by LOADER. Acceptable values 
are multiples of 100s . 
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Parameter 



IP.LRT 



IP.LDBG 



IP.FLMSG 



IP .MAP 



Default 







Significa nce 

If nonzero, a message giving various time and memory 
measurements is issued to the dayfile. 

If nonzero, conditional code to aid in debugging the loader is 
assembled. 

If nonzero, a dayfile message giving field length required for 
loading and execution is issued; applies for relocatable loads 
when no map is specified. This parameter is controlled by the 
unique parameter FLMSG on the call to the LOADER installation 
procedure. 

Default loader map option. This parameter is controlled by 
the unique parameter MAP on the call to the LOADER 
installation procedure. You can enter one of the following 
values: 



Value 



3 

13B 

17B 



Description 

Specifies MAP(OFF); no map. 

Specifies MAP(PART); statistics and block map. 

Specifies MAP(ON); statistics, block map, and 
entry point cross-references. 

Specifies MAP(FULL); statistics, block map, 
entry point map, and entry point 
cross-references . 



LOADER also uses the symbol IP.MECS, which is defined in IPARAMS during the installation of 
TEXT and TEXTIO. 
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MAS - MASS STORAGE ARCHIVAL SUBSYSTEM VERSION 1 

This subsection describes the following installation options for MAS: 

• Unique Parameters 

• MAS Procedure File 

• MAS Configuration File 

UNIQUE PARAMETERS 

SAVELIB If you want to save M86LIB as a direct access file, specify the keyword 
SAVELIB on the call to install MAS. 



MAS PROCEDURE FILE 

Refer to Subsystem Initiation, at the beginning of this section for more information about 
the MAS procedure file and about subsystem initiation. The OPL deckname for the MAS 
procedure is MAS. 



MAS CONFIGURATION FILE 

You must create an MAS configuration file using the SSBLD statements. Refer to the NOS 2 
Analysis Handbook for information about creating the MAS configuration file. SYSGEN(FULL) 
installs a sample MAS configuration file (named MSASCON) on user name SOBFAMO (user index 
377760 octal). 
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MCS - MESSAGE CONTROL SYSTEM VERSION 1 

This subsection describes the following: 
Unique Parameters 
Installation Parameters 
MCS Procedure File 
Special Notes 
Verification 

UNIQUE PARAMETERS 

TRACE If you want to activate the MCS debug facility, specify the keyword TRACE on the 
call to install MCS. 



INSTALLATION PARAMETERS 

The following parameters are defined in common deck IPA$MCS. To change these parameters, 
place the appropriate Update directives on file USER for the MCS installation job. 

Parameter Default Significance 

MAXFL 110000 Maximum field length (octal) to which MCS can expand. 

OUTLIMIT 60 Number of messages that can accumulate in an output queue 

before SEND requests are rejected. 

The following parameters assign relative weights to the various requests that a COBOL 
program can make to MCS. When the program disconnects from MCS, the accounting routine adds 
the corresponding weight factors of all requests and enters the total into the system 
account file. 



Parameter 


Default Value 


COBOL Request 


AC$ACCEPT 


1 


Accept. 


AC$CHECKPT 


1 


Check point. 


AC$DISABLE 


1 


Disable. 


AC$ENABLE 


1 


Enable. 


AC $ INITIAL 


2 


Initial. 


AC$PURGE 


2 


Purge. 


AC$RECEIVE 


3 


Receive. 


AC$SEND 


3 


Send. 


AC$STOPRUN 


2 


Stop run. 
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MCS PROCEDURE FILE 

Refer to the beginning of this section for information about the MCS procedure file and 
about subsystem initiation. 



note! 



When MCS is started by the NAMI master 
startup file, the ENABLE and DSD AUTO 
commands are not applicable to MCS. 



Parameters in the procedure control the following aspects of MCS initialization. 

• Default user name and family. 

• Default Application Definition Language (ADL) file name. 

• Operator interaction. 

The default user name for MCS is SYSTEMX. To change the user name, insert a USER command in 
the procedure that specifies the user name and family under which MCS is to run. 

To change the default ADL file, include an ATTACH or GET command in the procedure so that 
the local file name ADLLIB exists before MCS is called. If file ADLLIB does not exist 
locally, MCS tries to acquire a file with the name ADLLIB under either the default user name 
or the name specified with the USER command. 

Inclusion of a GO parameter on the MCS program call command prevents operator interaction 
during MCS initialization. 

The released MCS startup procedure attaches ADLLIB from the installation user name INSTALL 
and starts MCS automatically. 

Consider the following two procedures. 

Example 1: 

.PROC.MCS. 

RETURN, MCS. 

RFL, 60000. 

MCS, GO. 

EXIT. 

REWIND, ZZZZZDN. 

DLFP,I=0. 
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Example 2: 

•PROC.MCSTEST. 

USER, user-name .password ,f amilyname. 

RFL, 60000. 

ATTACH ,ADLLIB /UN=username . 

MCS. 

EXIT. 

REWIND, ZZZZZDN. 

DLFP,I=0. 

Example 1, the procedure named MCS, specifies the default user name (SYSTEMX) and the 
default ADL file (ADLLIB); it does not allow the operator to change initialization 
parameters . 

Example 2, the procedure named MCSTEST, specifies a different user name, family name, and 
ADL file and allows the operator to change initialization parameters. The call to DLFP is 
required only if you use a debug version of MCS. 



SPECIAL NOTES 

• To activate debug dumps for the ADL processor, include a *DEFINE DEBUG directive on 
file USER for the MCS installation job. 

• Users must be validated to access MCS (refer to MODVAL in the NOS 2 Administration 
Handbook). 
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VERIFICATION 

The following procedure verifies the correct installation of MCS, the ADL processor, and the 
COBOL communications facility. 

Run a job that executes the following command: 

BEGIN, VMCS1A, INSTALL. 

This job creates an application definition library file (ADLLIB) on the installation user 
name INSTALL. To start MCS processing, enter: 

SDBSTST. 

L. ENABLE, MCS, n. 

L.END 

MCS. 

n is the control point number. Then, to compile a sample COBOL job and execute MCS-related 
verbs, run a job that executes the following command: 

BEGIN, VMCS IB, INSTALL. 

Optionally, you can perform a part of the verification procedure at a terminal. Bring up 
NAM by entering at the system console these commands: 

SUBSYST. 

L. ENABLE, NAM, n. 

L.END 

NAM. 

n is the control point number. When NAM is up, log in at a terminal and specify MCS as the 
network application. After the MCS banner and prompt appear, enter: 

VERIFY AOP 

as the MCS application name and 

TERMINAL 1 

as the symbolic name. A verification message appears at the terminal. After verification 
is complete, enter: 

CFO, MCS. IDLE 

to terminate MCS. To terminate NAM, assign the NAM K display to NVF and enter the following 
R display command: 

R.DI.HO. 
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MSS - MASS STORAGE SUBSYSTEM VERSION 1 

This subsection describes the following installation options for MSS: 

• Unique Parameters 

• MSS Procedure File 

UNIQUE PARAMETERS 

SAVELIB If you want to save MSSLIB as a direct access file, specify the keyword 
SAVELIB on the call to install MSS. 



MSS PROCEDURE FILE 

Refer to Subsystem Initiation, at the beginning of this section, for information about the 
MSS procedure file and about subsystem initiation. 
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MSSI - MAP SUBSYSTEM AND INTERFACE VERSION 3 

There are four DECKOPL installation procedures for installing MSSI: MSSI, MMCL, AP1I, and 
AP1L. These procedures build the MAP subsystem, the MAP microcode to support a MAP III, MAP 
IV-20/21, and MAP IV-23/25, as well as online diagnostics. 



INSTALLATION PROCEDURES 

Here are the formats for calling the MAP installation procedures: 

BEGIN, MSSI , INSTALL ,FTN4 ,BLDMLIB,MSAMLIB=f ilename. 

BEGIN , MMCL , INSTALL , FTN4 . 

BEGIN ,AP1I , INSTALL ,FTN4 ,MEMSIZE=size . 

BEGIN ,AP1L , INSTALL ,FTN4 ,MAPTYPE=type . 

The MSSI procedure must be run before the AP1I procedure. Refer to the MSSI Version 3 
Installation Handbook for complete installation information. 

MSSI VALIDATION REQUIREMENTS 

The SYSGEN installation procedures for installing MSSI require the user names CDCCE and 
CDCCE2 (these user names can be changed, but they must be unique). The released passwords 
for the user names are the same as the user names. However, you can change the user names 
or passwords. 

In the subsystem startup procedures MAPCMI, MAPECS, and MAPCH a CCL .DATA file contains the 
directives : 

APlUN=username 
AP lPW-pas sword 

To change the user name or password, replace the parameter values username and password with 
the new user name and password. To use SYSGEN to load files to these user names, you must 
temporarily set the password and user names to the default values or you must modify SYSGEN. 



PROCEDURES FOR INITIATING MSSI 

CDC provides three procedure files for initiating MSSI: 
MAPCMI for initiating MAP IV-23/25 
MAPCH for initiating MAP IV-20/21 
MAPECS for inflating MAP III 
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NAM5 - NETWORK ACCESS METHODS VERSION 1 

This subsection describes the following installation options for NAM: 

• Special Notes 

• Unique Parameters 

• Local and Network Configuration Files 

• NAM Procedure File 

• USER File Directives 

• Network Startup Master File 

• SYSGEN Functions 

SPECIAL NOTES 

• The NAM installation procedure installs the following NAM components and utilities: 

NAMI (Network Initialization Program) 

NIP (Network Interface Program) 

PIP (Peripheral Interface Program) 

NS (Network Supervisor) 

CS (Communications Supervisor) 

NVF (Network Validation Facility) 

DLFP (Debug Log File Processor) 

AIP (Application Interface Program) 

QTRM (Queued Terminal Record Manager) 

TVF (Terminal Verification Facility) 

NDLP (Network Definition Language Processor) 

LFG (CCP Load File Generator) 

NDA (NPU Dump Analyzer) 

COLLECT (Collect Network Dumps) 

LISTPPM (Format PIP Memory Dumps) 

• The installation procedure retrieves the procedure and NAMSTRT files from the 
program library on NAM5. The installation procedure saves these files as public 
indirect access permanent files on the installation user name. The SYSGEN utility 
automatically moves the files to SYSTEMX and NETOPS. Other optional product 
installation procedures modify NAMSTRT (PSU, RBF, RHP with NAM interface, and ITF). 
Thus, you should not move NAMSTRT until these optional products have been installed. 

• The NDLP binaries must be in the running system or in GLOBLIB before creating the 
network and local configuration files, and the LFG binaries must be in GLOBLIB 
before creating the CCPLOAD file. If the current NDLP binaries are not in the 
running system but are in GLOBLIB (they are placed there by SEED and the NAM 
installation procedure), the following command must be included in the job that 
executes NDLP. (Execution of this command must occur before NDLP is executed.) 

BEGIN .ATTGLOB , INSTALL . 
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• The NAM1/CCP3 Host Application Programming Reference Manual describes NIP, PIP, NS, 
CS, AIP, QTRM, and DLFP. The NAM/CCP Terminal Interfaces Reference Manual describes 
TVF. The Network Definition Language Reference Manual describes NDLP. The NOS 2 
Analysis Handbook describes LFG, NAMI, COLLECT, and NDA. 

• There are interdependencies between NAM and CCP. These interdependencies are 
established in file USERBPS (refer to CROSS and CCP in this section). 

• The flow of supervisory and data messages through the network is traced by 
Application Interface Program (AIP) code, which creates log files of such messages. 
The data that the log files provide is invaluable in the analysis of error 
conditions in network installation or operation. Startup jobs JOBNS, JOBCS, JOBTVF, 
JOBNIP, and JOBNVF save the log files as direct access permanent files on tape and 
purges them. For network problems, this tape (with other support materials) should 
be included with all PSRs submitted for network products. A more detailed 
description of the log file capability is in the NAM1/CCP3 Host Application 
Programming Reference Manual. 



UNIQUE PARAMETERS 

NOTRACE If you want to disable log file creation for NS, NVF, TVF, and CS, specify 
the keyword NOTRACE on the call to the procedure for NAM installation. 



LOCAL AND NETWORK CONFIGURATION FILES 

You must create the local and network configuration files with NDLP. Define these files as 
direct access permanent files with the names specified in the master file parameter 
records. LCFFILE and NCFFILE are the file names specified in the released version of the 
master file. Refer to the Network Definition Language Reference Manual for the procedure to 
create the configuration files. 

LCFFILE and NCFFILE must be installed under user name NETOPS (user index 377772g). 
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NAM PROCEDURE FILE 

Refer to Subsystem Initiation, at the beginning of this section, for information about the 
NAM startup procedure file and subsystem initiation. 

There are two released initiation procedure files: NAM and NAMNOGO. Use the NAM procedure 
to initiate NAM without operator intervention; use the NAMNOGO procedure when operator 
intervention is required. 

A NAM procedure file causes the network initialization program NAMI to execute. NAMI takes 
input from a permanent file which it creates the first time it executes (under user name 
SYSTEMX), from its command parameters, and from the operator through CFO commands. Command 
parameters override the permanent file; operator entries override both the command 
parameters and the permanent file. 

The parameters to the NAMI command primarily identify a startup master file that NAMI uses 
to bring up network host programs. A GO parameter on the NAMI command brings up the network 
without operator intervention. This parameter is provided on the NAMI command in the NAM 
procedure, but it is absent in the NAMNOGO procedure. 

The first time the network programs are to be started, you should enter NAMNOGO to allow 
entry of the parameters necessary for it to execute. These parameters are the name of the 
startup master file, the user name and password under which the file resides, and the name 
of the parameter record on the master file containing additional directives to NAMI for 
starting the network programs. Enter the required parameters through the CFO command, 
ending with the GO parameter to start NAMI processing. Refer to the NOS 2 Analysis Handbook 
for a description of the NAMI command and for further details on NAMNOGO and the CFO command. 

The released startup master file, NAMSTRT, is a multirecord file containing six parameter 
records (INIT, RESTRT, RECOVR, MINIT, MULTI, and MRECOV) and seven job records (JOBNIP 
JOBNS, JOBCS, JOBNVF, JOBTVF, JOBCOL, and JOBPUR). For the initial NAM startup, you should 
specify the parameter record INIT for a single host network, or MINIT if your network 
contains more than one host. Subsequent entries of NAM from the console cause NAMI to use 
the parameter record RESTRT. If you have a multihost network, you should change the NAMI 
command in the NAM procedure file so that subsequent entries from the console use the 
parameter record MULTI. 

The INIT record directs NAMI to route to the input queue jobs to start the programs NS, CS, 
NVF, TVF, and COLLECT. NIP is started at the NAMI control point. If RBF, ITF, QTF, and MCS 
have been installed, the INIT record also routes a job to start those programs. 
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USER FILE DIRECTIVES 

To assemble the following features Into NAM, include directives of the form 

*DEFINE name 
on file USER for the NAM5 installation procedure. 



name 
DEBUG 



IMS 



STAT 



ZZDN 



NOTE 



You should be thoroughly familiar with NAM 
operations before defining DEBUG and/or 
STAT. DEBUG and STAT are defined by the 
release defaults. To remove the 
definitions, specify NOTRACE on the call to 
the NAM5 installation procedure. 



Significance When Defined 
Code to aid in debugging and maintenance in NIP and in PIP is generated. 
The following shows the effect of DEBUG on NAM components. 

• NIP, CS, NS, and NVF abort on certain error conditions. 

• CS, NS, and NVF are loaded with the debug version of AIP and produce 
network traces. 

• PIP hangs PPs for certain error conditions. 

• NIP uses internal trace buffers to trace messages sent and received and 
to trace subroutine and overlay calls . 

Descriptive internal maintenance comments are included in the assembly and 
compilation listings. 

Additional statistics-producing code is generated in NIP and AIP. With STAT 
defined, each time an application stops talking to the network, a 
terminal-to-application connection terminates, or an application-to-application 
connection terminates, statistical information is written to the NIP dayfile. 
After NIP terminates, the dayfile indicates the number of times each overlay was 
called and gives the statistics kept in common block STATTAB. 

The size of the job dayfile increases significantly when STAT is defined. 

Code is generated to log all inbound or outbound messages between PIP and NIP in 
local file ZZZZZDN. 



The following parameter is defined in deck INPARU. To make any changes to this parameter, 
place the appropriate Update directive on file USER when running the NAM5 installation job. 

Parameter Default Significance 

MAXNIP 24576 Maximum field length that NIP can reach. Range is 7680 to 

131071. 
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Use the following formula to determine a value for MAXNIP for a particular configuration. 
(Round MAXNIP to the nearest multiple of 64.) 



MAXNIP 



11096 + 340h + 6560a + m + k 1Wl + ... + k^ + 78b! + 142b 2 + 206b 3 



Variable 



k i w i 



Description 



Maximum number of host nodes . 



Maximum number of applications with up through eight application-to-application 
connections . 

Maximum node number. 

Words per terminal . This value must be determined for each of the terminals 
configured in the local configuration file. It depends upon both the 
application block limit and the network block limit defined for each terminal 
and the type of terminal, as follows: 



Variable 



Value 



Description 

Application block limit (ABL) and network block limit 
(NBL); one of the following values. 

Description 

ABL < 2 and NBL < 2. 

ABL > 2 and NBL < 2. 

ABL < 2 and NBL > 2. 

ABL > 2 and NBL > 2. 

Type of terminal; one of the following values. 

Description 

Connected interactive terminal. 

Connected batch terminal. 

Active batch terminal. 



Refer to the Network Definition Language Reference Manual for further 
information on ABL and NBL. 



1 




ABL - 1 




NBL - 1 




ABL + NBL - 


- 2 


w i 




Value 




20 




40 




140 
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Variable Description 

bi Maximum number of 64-word PRU buffers (N1PRUB) that can be allocated to NAM. 

b2 Maximum number of 128-word PRU buffers (N2PRUB) that can be allocated to NAM. 

b3 Maximum number of 192^word PRU buffers (N3PRUB) that can be allocated to NAM. 

The N1PRUB, N2PRUB, and N3PRUB variables are NIP command parameters. Refer to 
NIP - Network Interface Program, later in this section. 



| NOTE 



If you change the value of MAXNIP , you must 
also change the value of the COMSREM 
installation parameter NMFL. The two values 
should be the same. 
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NETWORK STARTUP MASTER FILE 

The master file that NAM uses to start network processing consists of a set of text records 
that are either parameter records or job skeleton records. The master file is in standard 
NOS text format. You can modify the file using a text editor or through Update directives 
against the NAM PL. 

A comment can follow the parameters on all statements and directives. 
To list the released master file, execute the command: 
BEGIN .NAMSLST , INSTALL . 



TITLE Statement 

The TITLE statement designates a parameter record or a job skeleton record. It must be the 
first statement (following the name of the record) of every record in the master file. The 
format follows : 

TITLE (type) title 

Parameter Significance 



type Type of record; use PARAM for parameter records and JOB for job 
skeleton records. 

title Text string of 1 through 50 characters that you can use to describe 
the purpose of the record. 

Example : 

TITLE (PARAM) INIT - INITIAL NETWORK INVOCATION 



Parameter Records 

Parameter records contain two kinds of directives that tell NAMI what parameters to 
substitute in job skeletons (PARAM directives) and what jobs to start (JOB directives) 
Each record can consist of a number of lines or directives up to 80 characters long 
terminated by a zero byte. Refer to the NOS 2 Analysis Handbook for a description of 
parameter records available with the released system. 

Refer to figure 5-11 for an example of a parameter record. 
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INIT 

TITLE(PARAM) INIT - INITIAL NETWORK INVOCATION. 

.* 

.* THIS PARAMETER RECORD IS SELECTED WHEN THE NETWORK 

.* IS TO BE STARTED WITH FRESH LOADS OF THE FIRST 

.* LEVEL NPU(S), AND THEIR PREVIOUS CONTENTS 

.* ARE NOT TO BE DUMPED. 

.* 

.* 

.* 1. PURGE ALL PREVIOUS NETWORK DUMPS AND TRACES. 

.* 

.* 2. LOCAL NPU(S) WILL BE STOPPED AND RELOADED 

.* WHEN THE NETWORK IS STARTED. 

.* 

.* 3. LOCAL NPU(S) WILL NOT BE DUMPED WHEN THEY 

.* ARE INITIALLY LOADED. 

.* 

.* 4. LOCAL NPU(S) WILL BE STOPPED IF THE HOST 

.* NETWORK FAILS. 

.* 

.* 5. A FAILING NPU WILL TRIGGER HOST SUPERVISOR 

.* PROGRAM FIELD LENGTH DUMPS TO BE TAKEN AND 

.* PREVIOUS TRACE FILES TO BE PRESERVED. 

.* 

PARAM(NCFFN=NCFFILE) NETWORK CONFIGURATION FILE. 

PARAM(LCFFN=LCFFILE) LOCAL CONFIGURATION FILE. 

PARAM(NLFFN=NLFFILE) NETWORK LOAD FILE (CCP). 

PARAM(NIISTP=YES) STOP NPU(S) AT HOST INITIALIZATION. 

PARAM(NSFDP=NO) INITIALLY LOADED NPU(S) NO DUMP. 

PARAM(NIFSTP=YES) STOP NPU(S) AT HOST FAILURE. 

PARAM(NSRT=YES) HOST DUMPS/TRACES ON NPU FAILURE. 

PARAM(ZZMC=500) MESSAGE COUNT BEFORE RELEASE TRACE FILE. 

PARAM(ZZWHLCT=10) MAX NUMBER OF AUTO RESTART OF PROGRAM. 



JOB(JOBPUR.CO) COLLECTOR JOB. 

JOB(JOBNIP.NIP) NAM (NIP) JOB. 

JOB(JOBNVF,NV) NVF JOB. 

JOB(JOBCS.CS) CS JOB. 

JOB(JOBNS.NS) NS JOB. 

JOB(JOBTVF.TV) TVF JOB. 



Figure 5-11. Example of Parameter Record 
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PARAM Directive 

The PARAM directive is used in the parameter record to define keywords and values that are 
substituted for matching keywords in the job skeleton records. PARAM has the following 
format. 

PARAMUeyword^value! ,keyword 2 -value 2 , . . .keyword n =value n ) comment 
Multiple PARAM directives can appear in a parameter record. 
The following rules apply to the PARAM directive: 

• Embedded spaces are ignored. 

• Keywords and values can contain only letters, digits, and asterisks. 

• Keywords and values must be no longer than 7 characters. 

• If a keyword appears more than once, only the first definition applies. 
Example: 

When the following directive is present, every occurrence of the keyword NCFFN in any job 
skeleton record is replaced by the string NCFFILE. 

PARAM(NCFFN=NCFFILE) NETWORK CONFIGURATION FILE. 
JOB Directive 

The JOB directive specifies the name of a job skeleton record and a code for the name of the 
network product that the job skeleton starts. A JOB directive must appear in every 
parameter record for each Network Host Products program that NAMI should start. The JOB 
directive has the following format: 

JOB(name,type,ssname,DI) comment 

Parameter Significance 

name Name of a job skeleton record. 

tv P e First two or more characters of an application or program name, such 

as NS, CS, NIP, and so on. (Only the first 2 characters are used.) 

ssname Subsystem name if program is a subsystem (not required for NIP). 

DI If specified, the job record is not started at network initiation, 

but it may be started later by using the NAMI RS option when the 
network is operational. 

The rules for format of a PARAM directive apply to the JOB directive. 
Example : 

JOB(JOBNIP,NIP) NAM (NIP) JOB. 
NAMI ignores all comment lines in the parameter record of the form 
•*Text 
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Job Skeleton Records 

Each job skeleton record contains the commands and input records required to start one 
network program. The record is in NOS job file format. In any of the commands or input 
record lines, any keyword ( 1 to 7 letters, digits, or asterisks, delimited by separators) 
may be a substitutable parameter. That is, if any keyword in the job skeleton record is 
identical to a keyword in the parameter record, NAMI substitutes the corresponding value 
from the parameter record for the keyword in the job skeleton. If a separator is an 
underscore, NAMI removes the underscore from the record when it makes the replacement. 

In addition to substituting values for keywords defined in the parameter record, NAMI also 
substitutes variables known to it at the time it executes. These variables pertain to the 
startup master file currently in use and to the names of dump and trace files which NAMI 
creates with each new startup of NIP. Certain reserved keywords have been defined for use 
in the job skeleton records wherever one of the NAMI variables should be substituted. 

Keyword Meaning 



CIN Current network invocation number. 

OIN Old network invocation number. 

UNM Master file user name. 

PWM Password for master file user name. 

MFN Master file name. 

The following keywords are defined by NAMI and should be used in the job skeleton record 
wherever the dump and trace files are to be referenced. 

Keyword Meaning 

xxDOFIL Program dumps. 

xxDlFIL 

xxD2FIL Binary dumps of field length. 

xxD3FIL 

xxLOFIL Listable output. 

xxTOFIL ZZZZZDN. 

xxSOFIL ZZZZZSN. 

xx is the first 2 characters of the type from the JOB directive in the parameter record. 
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Job skeleton records must be constructed so that the files whose existence Is assumed by the 
various programs are present. 

NAMI ignores all comment lines in the job skeleton record of the form: 
•*text 

NAMI writes an end-of-record in the submitted job when it encounters a card image of the 
following format in the job skeleton: 

.EOR 
Refer to figure 5-12 for an example of a job skeleton record. 
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J0BN1P 
TITLE (JOB) 
* 



JOBNIP - NIP RELEASE DEFAULT JOB SKELETON. 



THIS IS THE STARTUP JOB FOR NIP. 

THE PERMANENT FILES THAT NIP DUMPS AND TRACES ARE WRITTEN TO 
WILL BE COLLECTED BY THE COLLECTOR JOB ALONG WITH THE 
REST OF THE NETWORK TRACES AND DUMPS. 



THE FOLLOWING PARAMETERS MUST BE SET IN THE PARAMETER RECORD. 
NIISTP = STOP NPU(S) AT HOST INITIALIZATION. 
NIFSTP - STOP NPU(S) AT HOST TERMINATION. 
ZZMC = MESSAGE COUNT BEFORE RELEASE OF TRACE FILE. 

PERMANENT FILES FOR RUN DATA ARE DEFINED AT JOB TERMINATION. 



TFN 

OUTPUT 
ZZZZZPP 
ZZZZDMB 
ZZZZTMP 

ZZZZZDN 



LFN 

NIPOUT 

PIPDMP 

NIPDMB 

NIPZTMP 

NIPLST 

TRCLEV1 

TRCLEV2 

TRCLEV3 



PFN 

NIDOFIL 
NID1FIL 
NID2FIL 
NID3FIL 
NILOFIL 

ZZNIFIL 
NITOFIL 



CONTENTS 

OUTPUT FROM JOB (DMP.DMD.ECT) . 
PIP DUMPS ON REPRIEVE. 
BINARY FIELD LENGTH DUMPS. 
BINARY DUMP FILE. 
JOB DAYFILE. 

NIP TRACE FILE WRITTEN BY NIP. 
INTERMEDIATE NIP TRACE FILE. 
PERMANENT NIP TRACE FILE. 



USER(UNM.PWM) 

NORERUN. 

DISPLAY(DATE) 

DISPLAY (HID) 

DISPLAY(OT) 

DISPLAY (SC) 

RETURN (OUTPUT) 

SETJOB(NAMJCIN) 

.* 

.* PURGE OLD LEVEL 2 TRACE FILES. 

.* 

PURGE(ZZNI OIN.ZZNI CIN/NA) 



Figure 5-12. Example of Job Skeleton Record (Sheet 1 of 5) 
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.* 

.* START NIP. 

.* 

RFL (60000) 

NIP (NIN=CIN , ISTP=NIISTP ,FSTP=NIFSTP ,MC=ZZMC ) 

.* 

.* NIP NORMAL TERMINATION - CHECK FOR ABNORMAL CONDITIONS. 

.* 

RFL(O) 

SKIP (BAILOUT) 

.* 

EXIT. NIP 

.* 

.* 

.* NIP FAILED - SAVE RUN DATA IF REQUIRED. 

.* 

.* 

DISLAY(EF) 

IF(EF. NE. SYE .BAILOUT) 

SKIP(SAVFILS) 

.* 

END IF (BAILOUT) 

IF ( . NOT . FILE (ZZZZTMP ,AS )SAVFILS ) 

.* 

.* NO ABNORMAL CONDITIONS - DO NOT SAVE RUN DATA ON PERMANENT FILES. 

.* 

PURGE (NITOFIL,ZZNI_CIN/NA) 

RETURN (OUTPUT) 

WRITER (OUTPUT) 

EXIT. NIP 

.* 

.* SAVE RUN DATA IF AVAILABLE 

.* 
ENDIF(SAVFILS) 

.* 

IF(FILE (OUTPUT ,AS ) .NOUTPUT ) 

ATTACH (NIPOUT-NIDOFIL /NA.M^W) 

IF(.NOT.FILE(NIPOUT,AS)) DEFINE (NIPOUT=NIDOFIL) 

REWIND (OUTPUT) 

SKIPEI (NIPOUT) 

COPYEI (OUTPUT , NIPOUT ) 

RETURN (OUTPUT , NIPOUT ) 

ENDIF(NOUTPUT) 

.* 

IF (FILE (ZZZZZPP , AS ) , NOZZZPP ) 

ATTACH(PIPDMP=NID1FIL/NA,M=W) 

IF(.NOT.FILE(PIPDMP,AS)) DEFINE (PIPDMP-NID1FIL) 

REWIND (ZZZZZPP) 

SKIPEI(PIPDMP) 

COPYEI (ZZZZZPP , PIPDMP ) 

RETURN (ZZZZZPP , PIPDMP ) 

ENDIF (NOZZZPP) 

.* 

IF (FILE (ZZZZDMB , AS ) , NOZZDMB ) 
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ATTACH(NIPDMB=NID2FIL/NA,M=W) 

IF( .NOT.FILE(NIPDMB,AS)) DEFINE (NIPDMB=NID2FIL) 

REWIND (ZZZZDMB) 

SKIPEI(NIPDMB) 

COPYEI ( ZZZZDMB , NIPDMB ) 

RETURN( ZZZZDMB .NIPDMB) 

ENDIF(NOZZDMB) 

.* 

IF(FILE(ZZZZTMP,AS),NOZZTMP) 

ATTACH (NIPZTMP=NID3FIL/NA ,M=W) 

IF(.NOT.FILE(NIPZTMP,AS)) DEFINE(NIPZTMP=NID3FIL) 

REWIND (ZZZZTMP) 

SKIPEI (NIPZTMP) 

COPYEI ( ZZZZTMP , NIPZTMP ) 

RETURN( ZZZZTMP , NIPZTMP ) 

ENDIF(NOZZTMP) 

.* 

ATTACH(TRCLEV2=ZZNI_CIN/NA) 

IF(FILE(TRCLEV2,AS) .NTRCLV2) 

SKIPR(TRCLEV2) 

IF ( . NOT .F ILE ( TRCLEV2 , EOF ) ) REWIND ( TRCLEV2 ) 

ELSE(NTRCLV2) 

IF ( FILE ( ZZZZZDN , AS ) , NOTRACE ) 

ENDIF(NTRCLV2) 

ATTACH(TRCLEV3=NIT0FIL/NA,M=W) 

IF ( . NOT .F ILE ( TRCLEV3 , AS ) ) DEF INE ( TRCLEV3=NIT0F IL ) 

SKIPEI(TRCLEV3) 

COPYEI ( TRCLEV2 , TRCLEV3 ) 

PURGE( ZZNI_CIN/NA) 

IF(FILE(ZZZZZDN,AS) .NTRCLV1 ) 

RENAME(TRCLEV1=ZZZZZDN) 

REWIND (TRCLEV1) 

IF ( ZZMC . NE .0 ) SKIPR( TRCLEV 1 ) 

COPYBF ( TRCLEV 1 , TRCLEV3 ) 

BKSP(TRCLEV3) 

SKIPR(TRCLEV3) 

IF(.N0T.FILE(TRCLEV3,E0F)) WRITEF(TRCLEV3) 

ENDIF(NTRCLVl) 

RETURN(TRCLEV1 .TRCLEV2 ,TRCLEV3) 

ENDIF(NOTRACE) 

.* 

ATTACH(NIPLST=NILOFIL/NA,M=W) 

IF( .NOT.FILE(NIPLST.AS)) DEFINE(NIPLST=NILOFIL) 

SKIPEI(NIPLST) 

N0TE(DFL, NR) /NIDAJCIN 

DAYFILE(DFL) 

PACK(DFL) 

COPEI(DFL,NIPLST) 

.* 

RETURN(OUTPUT) 

WRITER( OUTPUT) 

EXIT. NIP 

• EOR 

.* 



Figure 5-12. Example of Job Skeleton Record (Sheet 3 of 5) 
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THIS CONSTRAINS THE SIZE OF THE TRACE FILE KEPT 
WHEN THE NETWORK IS RUNNING WITHOUT ANY PROBLEMS 



.* 

.* 

.* 

.* THIS JOB IS SUBMITTED EVERY ZZMC MESSAGES TO PLACE 

.* THE TRACE INFORMATION FROM THE PROGRAM (LEVEL 1) ONTO 

.* THE INTERMEDIATE PERMANENT FILE ZZNIFIL (LEVEL 2). 

• * 

.* 

.* IF ALL THAT HAPPENS IS THAT THIS JOB IS REPEATEDLY 

.* SUBMITTED THEN THE TRACE INFORMATION IS KEPT FOR 

.* ONLY THE LAST 2 TIMES ZZMC MESSAGES. 

.* 

.* 

.* 

.* 

.* 

NIPA_CIN,T77777. DUMP AIP TRACE. TO ZZNIFIL. 

USER(UNM,PWM) 

ATTACH(TRCLEV2=ZZNI_CIN/M=W, NA) 

IF(FILE(TRCLEV2,AS)NTRCLV2) 

SKIPF(TRCLEV2) 

COPYBF ( TRCLE V2 , TEMP ) 

REWIND ( TRCLE V2 , TEMP ) 

COPYBF ( TEMP , TRCLE V2 ) 

ELSE(NTRCLV2) 

DEF INE ( TRCLE V2=ZZNI_C IN ) 

WRITEF(TRCLEV2) 

ENDIF(NTRCLV2) 

COPYBF ( INPUT , TRCLEV2 ) 

BKSP(TRCLEV2) 

SKIPR(TRCLEV2) 

IF( .NOT.FILE(TRCLEV2,EOF)) WRITEF(TRCLEV2) 

SETJOB(DC-NO) 

EXIT. NIPA 

.EOR 

.* 



Figure 5-12. Example of Job Skeleton Record (Sheet 4 of 5) 
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.* 

.* THIS JOB IS SUBMITTED IN RESPONSE TO A 

.* *HOP RELEASE DEBUG LOGFILE* COMMAND 

.* 

.* THE PURPOSE OF THIS JOB IS TO SAVE ON THE LEVEL 3 PERMANENT 

.* FILE *NITOFIL* THE PREVIOUS 2 TIMES ZZMC MESSAGES 

.* CURRENTLY IN THE INTERMEDIATE (LEVEL 2) FILE *ZZNIFIL* 

.* BEFORE WRITING THE NEW TRACE DATA (FROM LEVEL 1 FILE) 

.* ON THE INTERMEDIATE (LEVEL 2) FILE. THIS WILL ALLOW THESE 

.* TRACE MESSAGES TO BE COLLECTED AND WRITTEN TO TAPE 

.* 

.* 

NIPB_CIN,T77777. DUMP TO PERMANENT TRACE FILE. 

USER(UNM.PWM) 

ATTACH (TRCLEV2=ZZNI_CIN /M=W , NA ) 

IF(FILE (TRCLEV2 , AS ) , NTRCLV2 ) 

SKIPR(TRCLEV2) 

IF(.NOT.FILE(TRCLEV2,EOF)) REWIND (TRCLEV2) 

ATTACH(TRCLEV3*NTT0FIL/NA,M=«) 

IF ( . NOT . FILE (TRCLE V3 ,AS ) ) DEFINE (TRCLEV3-NIT0FIL ) 

SKIPEI(TRCLEV3) 

COPYEI (TRCLEV2 , TRCLEV3 ) 

EVICT (TRCLEV2) 

ELSE(NTRCLV2) 

DEFINE (TRCLEV2=ZZNI_CIN) 

ENDIF(NTRCLV2) 

WRITEF(TRCLEV2) 

COPYBF (INPUT , TRCLE V2 ) 

BKSP(TRCLEV2) 

SKTPR (TRCLE V2) 

IF(.N0T.FILE(TRCLEV2,E0F)) WRITEF( TRCLE V2) 

SETJOB(DC=NO) 

EXIT. NIPB 



Figure 5-12. Example of Job Skeleton Record (Sheet 5 of 5) 
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Network Host Product (NHP) Program Requirements 

Job skeleton records for the CS, NIP, NS, and NVF jobs must each contain a command that 
calls the program that the job Intends to run. These commands have the following format: 

prog(keywordj=valuei , . . .keyword n =value n ) 

P r og Program Name 

keyword^value^ Order-independent parameters; optional unless otherwise 

specified. 

The files used by each program are listed following the description of each program command. 



CS - Communications Supervisor 

CS requires the following command. 

CS (MC=mc , NIN=nin , CP=cputil ,BU=buf ut 11 ) 

Parameter Description 

MC=mc Maximum message count; specifies the maximum number of messages to be 

accumulated in the debug log file before NETREL is called. No NETREL 
call is issued if mc is 0. The default value is 500. 

NIN=nin Network invocation number; 1- to 3-digit decimal number assigned by 
NAMI when the network operation is started. This parameter is 
required. 

CP=cputil CPU utilization threshold for NPUs, from 50 through 100. The default 
is 100. If CPU utilization exceeds this value, the NPU operator is 
alerted. 

BU=bufutil Buffer utilization threshold for NPUs, from through 500. The 

default is 0. If available buffers drop below this level, the NPU 
operator is notified. 

CS may not be required in every host of a multihost network. If you do not want CS, remove 
the CS job statments from the network startup master file. 
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CS requires the following files. 

Name Description 



NCF Network configuration file created by NDLP. 

NRF1 Job record to be copied to the ZZZZZDN file by NETREL, that determines the 

disposition of the network trace file, when NETREL is called on a periodic basis 

NRF2 Job record to be copied to the ZZZZZDN file by NETREL, that determines the 

disposition of the network trace file, when NETREL is called as a result of an 
operator command or NPU failure. 



NOTE 



The default job skeleton for CS creates NRF1 
and NRF2 from the input records of the CS 
job. 
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NIP - Network Interface Program 

NIP requires the following command. 

NIP(NIN=nln,MC=mc,ISTP=lstp,FSTP=fstp,NlPRUB=nlprub,N2PRUB=n2prub,N3PRUB=n3prub,INACT=lto) | 



NOTE 1 



If a value less than the minimum is 
supplied, the minimum value is used. 



Parameter 



NIN=nin 



MC=mc 



ISTP=istp 



FSTP=fstp 



Description 

Network invocation number; 1- to 3-digit decimal number assigned 
by NAMI when the network operation is started. This parameter is 
required. 

Maximum message count; specifies the maximum number of messages to 
be accumulated In the debug log file before NETREL is called. No 
NETREL call is issued if mc is 0. The default value is 0. 

Option to stop all local NPUs during network host initialization. 
The default is NO. 

istp Significance 

YES Stop all local NPUs. 

NO Do not stop local NPUs. 

Option to stop all local NPUs upon network host termination. The 
default is YES. 



INACT=ito 



NlPRUB=nlprub 



fstp Significance 

YES Stop all local NPUs. 

NO Do not stop local NPUs. 

Inactive timeout. Time in minutes for connection to be inactive. 
Default is 10 minutes. After such period NIP will send 
FC/INACT/SM to application. If the value is zero, no FC/INACT/SM 
will be sent. 

Maximum number of 64-word buffers that can be allocated per 
driver. This value is dependent on the number of batch devices 
and application-to-applicatlon connections whose UBZ or DBZ is 
specified to be 640 characters or fewer. The default value is 4. 
The minimum value is 2. 
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Parameter 



N2PRUB=n2prub 



Description 

Maximum number of 128-word buffers that can be allocated per 
driver. This value Is dependent on the number of batch devices 
and application-to-application connections whose UBZ or DBZ is 
specified to be 1280 characters or fewer. The default value is 
8. The minimum value is 4. 



N3PRUB=n3prub 



Maximum number of 192^word buffers that can be allocated per 
driver. This value is dependent on the number of batch devices 
and application-to-application connections whose UBZ or DBZ is 
specified to be 1920 characters or fewer. The default value is 
4. The minimum value is 2. 



Correct PRU buffer allocation increases the throughput of the host software for batch data 
and significantly reduces the host software's resource use when it is handling batch 
traffic. The buffers specified by the values nlprub, n2prub, and n3prub are shared between 
all copies of PIP and all active PRU streams. The network configuration file allows you to 
select the number of PRUs to be transferred on connections with batch devices between the 
PIP and the NPU. 

Since performance is related to available buffers, correct PRO buffer allocation is 
important. In general, a PRU buffer can support from four through six active data streams 
at 9600 baud. The suggested configuration is two 64-word PRU buffers (N1PRUB=2) two 
128-word PRU buffers (N2PRUB=2), and two 192-word PRU buffers (N3PRUB-2) if PIP supports the 
PRU data transfers on all three PRU buffer sizes. 

To determine if the PRU buffer allocation is correct, assemble the statistics feature (STAT) 
into NAM. STAT causes the NAM dayfile to display at network termination the percentage of 
PRU buffer use. Ideally, the batch buffer use should be between 50 percent and 70 percent. 
To determine if the percentage of PRU buffer use is correct at your installation, load the 
network and run a typical remote batch load. At the completion of the run, terminate the 
network. Once the PRU buffer allocation is correct, you may want to recompile NAM with STAT 
turned off, because the statistics feature increases the size of the job dayfile. 



NOTE 



Leave PIP and its associated overlays on 
disk. Moving these overlays to central 
memory does not increase performance, since 
PIP copies its transient overlays to NAM's 
field length during its initialization. 
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NS - Networks Supervisor 

NS requires the following command: 

NS (NIN-nin ,FDP=f dp, RT=rt ,MC=mc ,NDFCT=option) 
Parameter 



Description 



NIN=nin 



FDP=fdp 



RT=rt 



MC=mc 



NDFCT=option 



Network invocation number; 1- to 3-digit decimal number assigned 
by NAM! when the network operation is started. This parameter is 
required. 



Forced dump option, 
fdp 



Significance 



YES 



NO 



Within the first 10 minutes of program execution, 
in the absence of other NPU dumping conditions, 
NPUs are dumped before loading takes place. 

NPUs are not dumped. The default is NO. 



Release trace file option, 
rt 



Significance 



YES NAM requests NS programs CS and NVF to release 

their trace files whenever NS dumps an NPU. The 
default is YES. 



NO 



Trace files are not requested to be released. 



Maximum message count; specifies the maximum number of messages to 
be accumulated in the debug log file before NETREL is called. No 
NETREL call is issued if mc is 0. The default value is 500. 

File category of NPU dump files. The following options can be 
specified. 



option 



Significance 



PU 


Public file 


s 


Semiprivate file. 


p 


Private file. 



NS may not be required to run in every host of a multihost network. If you do not want NS, 
remove the NS job statements from the network startup master file. 
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NS requires the following files: 
Name 



Description 



NLF 



NCF, NRF1, 
and NRF2 



Network load file created by LFG in the CCPLOAD procedure (refer to the NOS 2 
Analysis Handbook, for a description of LFG). 

Described under CS, earlier in this section. 



NVF - Network Validation Facility 

NVF requires the following command: 
NVF(AL=arl ,LL=lrl ,MC=mc ,NIN=nin) 
Parameter 



Description 



AL=arl 



LL=lrl 



MC=mc 



NIN=nin 



Application retry limit. This parameter specifies the maximum 
number of invalid application connection request attempts an 
application is allowed before NVF considers the application to be 
breaching security and aborts the application. The value can range 
from 1 through 4. The default is 1. 

Login retry limit. This parameter specifies the maximum number of 
invalid login attempts a user is allowed before NVF considers the 
user to be breaching security and terminates the connection. The 
value can range from 1 through 4. The default is 4. 

Maximum message count; specifies the maximum number of messages to 
be accumulated in the debug log file before NETREL is called. No 
NETREL call is issued if mc is 0. The default value is 500. 

Network invocation number; 1- to 3-digit decimal number assigned by 
NAM I when the network operation is started. This parameter is 
required. 



NVF requires the following files: 

Name Description 



LCF The local configuration file created by NDLP. 

NRF1 and NRF2 Described under CS, earlier in this section. 
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SYSGEN FUNCTIONS 

Use the SYSGEN(MOVE) utility to place the files NAM and NAMNOGO on the system user index 
(377777g) and to place the local and network configuration files created with NDLP, the 
NAMI startup master file, and the load file created by LFG under the user name NETOPS (user 
index 3777 72 g ). The default file names for these files are LCFFILE, NCFFILE, NAMSTRT, and 
NLFFILE, respectively. The NAMI startup master file must be a public file. 

SYSGEN(FULL) installs a complete NAMSTRT file to user name NETOPS with all related products 
(PSU, RBF, RHP with NAM interface, and ITF) merged with NAMSTRT. SYSGEN(FULL) also installs 
NAM and NAMNOGO to the user name SYSTEMX. SYSGEN (SOURCE) loads a copy of the standard 
NAMSTRT (no applications added) and a copy of the released Network Definition file (NDLDATA) 
to user name INSTALL. Default network configuration files (NCFFILE and LCFFILE) are 
installed to user name NETOPS, depending on the CCP option you selected from the OIP. 
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NOS AND NOS2B - NETWORK OPERATING SYSTEM 

The NOS procedure assembles all COMPASS routines; the N0S2B procedure compiles the FORTRAN 
and SYMPL routines. 



INSTALLATION PARAMETERS IN NOS DECKS 

You can modify installation parameters for the operating system by following these steps: 

• Execute the MODOPL procedure, incorporating any corrective code (corrective code can 
change the deck line numbers). 

• Get a listing of the deck that contains the parameter you want to change. From the 
listing, get information such as line numbers, which you need to change an 
installation parameter. 

• Put the NOS installation deck parameter changes on file USER and again execute the 
MODOPL procedure. 

If you change any of the installation parameters in a NOS deck, reassemble all routines that 
use that deck. Use the KRONREF command to determine which routines use the NOS deck. 

Refer to table 5-7 for brief descriptions of the NOS common decks that contain installation 
parameters. 
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Table 5-7. HOS Common Decks 



Common 
Deck Name 


A Deck That Calls 
the Common Deck 


Description 


COMEIPR 


CALLMSS 


Mass Storage Subsystem (MSS) parameters. 


COMSACC 


CALLSYS 


User validation limits. 


COMSBIO 


CALLSYS 


Central site batch I/O parameters. 


COMSIOQ 


CALLSYS 


Dayfile/QPROTECT equivalences. 


COMSJIO 


CALLSYS 


Devices to which users route files. 


COMSLSD 


CALLSYS 


Search for label sector of a mass storage device. 


COMSMLS 


CALLSYS 


Specifies micros that define multilevel security 
access levels and access categories. 


COMSMSC 


CALLSYS 


Miscellaneous parameters for the operating 
system. 


COMSMTX 


CALLSYS 


Magnetic tape executive routine and magnetic 
tape processing routine parameters. 


COMSPFM 


CALLSYS 


Permanent file symbols and locations and formats 
of call blocks, catalog, and permit entries. 


COMSPRO 


CALLSYS 


PROFILa parameters. 


COMSREM 


CALLSYS 


Interactive Facility (IAF) parameters. 


COMSRSX 


CALLSYS 


Job resource executive parameters. 


COMSSCD 


CALLSYS 


Service class definitions 


COMSSFS 


CALLSYS 


Field length limit for execution of MODVAL and 
PROFILE commands. 


COMSSRD 


CALLSYS 


Parameters used in SRU calculations. 


COMSSSJ 


CALLSYS 


Special system job parameters. 


COMS1DS 


CALLSYS 


IDS function code definitions. 


COMTNAP 


CALLTAB 


Valid network application parameters. 


COMUSIT 


CALLMSS 


ASMOVE utility parameters. 


COMXIPR 


CALLFAS 


Mass Storage Extended Subsystem (MAS) parameters. 


PPCOM 


PPTEXT 


Maximum number of EST entries, length of 
L-display input and output buffers, and number 
of mass storage devices. 
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COMEIPR Parameters 

COMEIPR contains the following parameters used by the MSS executive (MSSEXEC). Assemble 
CALLMSS to obtain a listing of COMEIPR. 



Parameter 
NUMSLV 

NUMRB 

SLRP$INTV 

SLAV$INTV 



Default 



60 



Significance 

The number of slave mainframes for which the master MSSEXEC 
can service file staging requests. 

The number of file staging request blocks available to a slave 
mainframe. 

The number of seconds that MSSEXEC waits to look for new 
staging requests from the slave mainframes. 

The number of seconds that MSSEXEC waits with no signal from a 
slave mainframe before assuming that the slave executive has 
terminated . 



COMSACC Parameters 

COMSACC contains a general description of the user validation file. Assemble CALLSYS to 
obtain a listing of COMSACC. 



Parameter 



APFN 



Default Significance 

VALIDUS Micro definition that specifies the name of the file 

containing the user names that validate user access to the 
operating system. Refer to the NOS 2 Analysis Handbook for 
further information on VALIDUS. 



AUFN 



VALINDS Micro definition that specifies the name of the available user 
indexes file. Refer to the NOS 2 Analysis Handbook for 
further information on VALINDS. 
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The NOS 2 Analysis Handbook describes the use of the following COMSACC user control 
parameters. 



Parameter 



APXL 



APXT 

KTLI 

KLPI 
KCPI 
KMSI 

KDF1 

KCCI 

KECI 

KCMI 

KSLI 
KDTI 

KPTI 



Default Significance 

7777g User password expiration term limit in days, from 1 through 
77773. This value establishes the upper limit on the 
expiration term that the user can specify with the XT 
parameter on the PASSWOR command (refer to the NOS 2 Reference 
Set, Volume 3). 

7777g Default user password expiration term in days, from 1 through 
77778. This value is assumed when MODVAL sets a password 
for a new user name. APXT must be less than or equal to 
APXL. A value of 7777g indicates the password cannot expire. 



10B 



1000B 



1000B 



100B 



100B 



37B 

10B 


1000B 



Value used in calculating the default time limit; the maximum 
value is 176g. For details of the algorithm used in the 
calculation, refer to the NOS 2 Analysis Handbook. 

Default limit for lines printed from a file; the maximum value 
is 3776g. 

Default limit for cards punched from a file; the maximum value 
is 76g. 

Default limit for additionally allocated mass storage PRUs; 
the maximum value is 7776g. 

Default limit for dayfile messages written; the maximum value 
is 176g. 

Default limit for commands processed; the maximum value is 
176 8 . 

Default limit for extended memory field length/lOOOg; the 
maximum value is 176g. 

Default limit for central memory field length/100g; the 
maximum value is 37g. 

Default limit for SRU accumulation; the maximum value is 76g. 

Default limit for the number of detached jobs; the maximum 
value is 373. 

Default limit for the number of units plotted; the maximum 
value is 760OOg. 
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COMSBIO Parameters 

COHSBIO contains the following parameters, which are used for control of BIO functions. 
Assemble CALLSYS to obtain a listing of COMSBIO. 



Parameter 



PL6L 



Default 



64 



PL8L 



85 



Significance 

Number of lines of print a user is charged for each page of 
output printed by BIO at six lines per inch. 

Number of lines of print a user is charged for each page of 
output printed by BIO at eight lines per inch. 



COMSIOQ Parameters 

COMSIOQ contains the following parameter, which is used for control of terminated dayfiles. 
Assemble CALLSYS to obtain a listing of COMSIOQ. 



Parameter 



USRN 



Default 



null 



Significance 

Micro definition that specifies the user name to which 
terminated dayfiles should be permitted. 



COMSJIO Parameters 

COMSJIO contains the following parameters, which define the devices to which the site allows 
users to route files. Two-character disposition codes, corresponding to the device codes 
defined for the ROUTE command, followed by a $ identify the legal devices. Assemble CALLSYS 
to obtain a listing of COMSJIO. 



Parameter 


Default 


Significance 


LP$ 


Defined 


Any line printer. 


PR$ 


Defined 


Any line printer. 


LR$ 


Defined 


Any 580-12 printer. 


LS$ 


Defined 


Any 580-16 printer. 


LT$ 


Defined 


Any 580-20 printer. 


SB$ 


Defined 


Punch system binary. 


PB$ 


Defined 


Punch system binary. 


P8$ 


Defined 


Punch 80-column binary 


PU$ 


Defined 


Punch coded. 


PH$ 


Defined 


Punch coded. 


PL$ 


Defined 


Plotter. 
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COMSLSD Parameters 



COMSLSD contains the following parameter, which references information maintained in the 
label sector of a mass storage device. Assemble CALLSYS to obtain a listing of COMSLSD. 



Parameter 



Default Value 



Significance 



LTKL 



20B 



If you did not initialize a mass storage device during 
deadstart (using the INITIALIZE entry described in the NOS 
Analysis Handbook ), the system searches the device for a 
label that might be in track 0. 



This parameter specifies the number of tracks the system 
searches before determining that the device has a bad label 
or no label. When it reaches that track number (in the 
released system, track 20g), it stops searching for a 
label. If the device is a system device, the system writes 
a new label; if it is not a system device, the error codes 
LE (label error) and U (unavailable) status are entered in 
the mass storage table (MST), and the device must be 
initialized after deadstart. MST is described in the NOS 2 
Analysis Handbook. 



COMSMLS Parameters 



COMSMLS contains micros that define security access levels and access categories. 
Redefining any of the access level or access category micros requires reassembly of all 

A site security administrator supplies any changes to be made 
to obtain a listing of CCMSMLS. 



programs that reference them. 

to these micros. Assemble CALLSYS 



Parameter 



ALMO through 
ALM7 



Default 

LVLO through 
LVL7 



Significance 



Micro definitions that specify the names of access level 
through access level 7. 



ACM00 through 
ACM31 



CAT00 through 
CAT31 



Micro definitions that specify the names of access category 
00 through access category 31. 
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COMSMSC Parameters 

COMSMSC contains the following miscellaneous parameters, which are used by the operating 
system. Assemble CALLSYS to obtain a listing of COMSMSC. 



Parameter 



MXSY 



Default 



AFDL 


20000B 


BLTL 


1000B 


DFDL 


20000B 


ELDL 


1000B 


UPTL 


10B 



Significance 

Maximum number of devices that can be defined as system 
devices during deadstart. 

Account file threshold size in PRUs.t 

Binary maintenance log threshold size in PRUs.t 

Dayfile threshold size in PRUs.t 

Error log threshold size in PRUs.t 

Maximum number of uncorrected processor errors that can occur 
per hour before the operator is notified. 



twhen entries in any of these files reach the threshold, the A, OPERATOR flashing message 
appears on the console screen (refer to the NOS 2 Analysis Handbook). 
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COMSMTX Parameters 

COMSMTX contains the following parameters, which are used by the magnetic tape executive 
routine and by related magnetic tape processing routines. Assemble CALLSYS to obtain a 
listing of COMSMTX. 



Parameter 
MUNIT 
NTIM 



POLM 



POGH 



Default Significance 

16D Maximum number of tape units defined per mainframe. 

300 Delay time in seconds (decimal) before reissuing the CHECK, 
E,P DISPLAY message at MAGNET's control point when entries 
exist in MAGNET's preview buffers. 

Flag indicating whether all tape hardware error messages are 

issued to the job dayfile. If POLM is 0, the system issues 
only the first and last messages to the job dayfile. If POLM 
is 1, the system issues all tape error messages to the 
dayfile. The user can override the installation setting of 
POLM with parameters on the tape assignment command (refer to 
the NOS 2 Reference Set, Volume 3). 

The system issues all tape error messages to the error log 
regardless of the setting of POLM. 

Flag indicating whether the system allows hardware-detected 

correctable errors when writing on 6250-cpi group-encoded 
(GE) tapes. The user can override the installation setting 
of POGH with parameters on the tape assignment command (refer 
to the NOS 2 Reference Set, Volume 3). 

If POGH is 0, the tape subsystem performs write error 
correction according to industry standard group-coded 
recording (GCR) techniques. Control Data recommends this 
setting because it provides efficient throughput, error 
recovery, and tape use when writing GE tapes on media 
suitable for use at 1600 cpi or 6250 cpi. 

If POGH is 1, hardware GCR error correction is disabled. 
Control Data recommends this option only for special 
archiving and diagnostic applications. Successful use 
requires higher-than-normal quality tape and special drive 
adjustments. Use in a normal environment generally results 
in increased error rates, decreased throughput, and decreased 
tape capacity. Use only tape that is suitable for recording 
at 6250 cpi when this setting of POGH is in effect. Because 
use of the disabled GCR error correction mode (also known as 
perfect write) may necessitate additional maintenance 
activities, consult site maintenance personnel before making 
this the default mode of operation. 
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Parameter 



ZFAM 



Default 



Significance 



A null micro Enables conversion of binary zero family names to nonzero 
family names. ZFAM allows users to continue to access 
labeled tapes that are restricted to owner access (file 
accessibility field in HDR1 label is A) and were built under 
the binary zero family. If ZFAM is a null micro, the system 
default family name is substituted for the binary zero family 
name; otherwise, ZFAM specifies the name to be substituted. 



COMSPFM Parameters 

CQMSFFM contains the following parameters, which are used for permanent file symbols and 
locations, formats of call blocks, and catalog and permit entries. Assemble CALLSYS to 
obtain a listing of COMSPFM. 



Parameter 



AP10 



Default Significance 

Auxiliary pack load option. This parameter controls whether 

or not a user can request an auxiliary pack to be loaded via 
an MFLINK request. When APLO equals 0, MFLINK requests to 
auxiliary packs not currently mounted are rejected with the 
message DEVICE UNAVAILABLE. When APLO is equated to a 
nonzero value, such MFLINK requests may roll out while 
waiting for the pack to be mounted (provided the user 
specified the NA or WB parameter). Since there is no global 
resource executive in an LCN environment, a potential of a 
temporary deadlock exists in the latter instance. If this 
happens, the RHF applications involved will be timed-out and 
aborted. 



DFPT 



DI1 



Equipment type. When accessing an auxiliary device with a 
permanent file command, the permanent file manager checks 
that the equipment type and pack name of the device match the 
equipment type (R parameter) and pack name on the command. 
If R is not specified, the system uses the equipment type 
specified by DFPT. If the default is used for another 
equipment type, the error message INCORRECT DEVICE REQUEST 
occurs. 



FPXL 



7777 8 



FPXT 



7777 8 



Permanent file password or permission term limit in days, 
from 1 through 7777g. This value establishes the upper 
limit on the expiration term that a user can specify on a 
permanent file request. Changes to this parameter should be 
supplied by a site security administrator. 

Default permanent file password or permission term in days, 
from 1 through 7777 8 . This value is assumed when the user 
does not specify an expiration term parameter on a permanent 
file request. FPXT must be less than or equal to FPXL. A 
value of 7777g indicates the password or permission cannot 
expire. Changes to this parameter should be supplied by a 
site security administrator. 
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Parameter 



MNHS 



Default 



Significance 

Minimum size hole, in sectors, that permanent file manager 
(PFM) creates in the indirect access file chain when using an 
existing hole. If, in the search for a hole in which to save 
an indirect access file, PFM finds that the use of an 
existing hole creates a new hole containing fewer sectors 
than MNHS, then PFM allocates space at the end of the 
indirect access chain. If a delink operation creates a hole 
smaller than MNHS, PFM delinks one less track to ensure 
minimum size for the hole. The purging of a file whose total 
length is less than MNHS results in the creation of a hole 
smaller than MNHS. 



BRDE 



BRAL 



RSDE 



RSNP 



If a value for MNHS is smaller than the average length of the 
indirect access files on the system, it results in holes that 
may be unusable. If the value is larger than the average 
file length, it results in holes which are not used for a 
period of time. For efficient use of holes, the value for 
MNHS should be close to the average length of the indirect 
access files on the system. 

The minimum value for MNHS is 3; the maximum value is 7777g. | 

Backup requirement (BR) default specifications; can be set to 
the following symbolic values. 

Value Description 

BRAL Backup always required. 

BRMD Media-dependent backup for systems with an 
alternative mass storage facility. 



BRNO 



No backup required. 



Preferred residence (PR) default specification; can be set to 
the following symbolic values. 



PMLM 



PGUI 



Value Description 

RSMS Mass storage facility residence preferred. 

RSNP No preferred residence. 

62|Q Number of explicit permissions allowed per file, 1 through 

4095. If PMLM is changed, PFM must be reassembled. 

300000 8 PFDUMP (refer to the NOS 2 Analysis Handbook) purge limit 
user index. When PFDUMP is used with the purge option, 
selected files under user indexes greater than PGUI are 
dumped, but not purged. If PGUI is changed, PFDUMP must be 
reassembled. 
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For individual users, each of four permanent file access limits is established through 
MODVAL (refer to the NOS 2 Administration Handbook) by specifying a range index from 
through 7. Each range index corresponds to an upper limit specified by one of the following 
installation parameters. The last character of the installation parameter indicates the 
range index being defined. Table 5-8 summarizes the released values for each parameter. 
Setting a parameter to indicates unlimited access. 



Parameter 
NFRNGn 
CSRNGn 

FSRNGn 

DSRNGn 



Significance 

Upper limit of range n for file count; must not exceed 777773. 

Upper limit of range n for cumulative size of indirect access files, 
specified in PRUs; must not exceed 777777g. 

Upper limit of range n for size of individual indirect access files, 
specified in PRUs; must not exceed 77777g. 

Upper limit of range n for size of individual direct access files, 
specified in PRUs; must not exceed 777777g. 



Table 5-8. Released Values of Permanent File Limit Ranges 



Parameter 




Values of n 








1 2 


3 4 


5 


6 


7 


NFRNGn 


10 20 


30 40 


50 


100 





CSRNGn 


1000 2000 


5000 10000 


50000 


100000 





FSRNGn 


10 30 


50 100 


150 


300 





DSRNGn 


1000 . 2000 


5000 10000 


50000 


100000 





All values 


are specified in octal; 


indicates unlimited 


access . 
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COMSPRO Parameters 

The following COMSPRO parameters contain a general description of the PROFILa file. 
Assemble CALLSYS to obtain a listing of COMSPRO. 



Parameter 



PPFN 



PPWD 



PUSN 



Default Significance 

PROFILC Micro definition specifying the PROFILE routine's database 
file name (refer to the NOS 2 Administration Handbook). 

SECURUS Micro definition specifying the PROFILE routine's database 
file password. 

SYSTEMX Micro definition specifying the catalog location of the 
PROFILE routine's database. 



COMSREM Parameters 

COMSREM contains the following parameters, which are used by the Interactive Facility (IAF) 
executive. Assemble CALLSYS to obtain a listing of COMSREM. 



Parameter 



UTIS 



Default 



10D 



Significance 

Value used in calculating the default CPU time limit in 
seconds for any particular terminal job's activity, if it is 
not specified with the SETTL command (refer to the NOS 2 
Reference Set, Volume 3). For details of the algorithm used 
in calculating the default time limit, refer to the NOS 2 
Administration Handbook. 



VDSI 


100B 


VDTI 


100B 


VXLL 


2500D 


VXPH 


2500D 



Default system resource unit (SRU) and time limit 
increment values for the S.nnnnn and T,nnnnn interactive 
commands • 

Maximum number of characters in a logical input line. 

Determines the physical line length that IAF accepts. IAF 
uses VXPH to calculate a buffer length. 



TAPC 



10B 



Number of pots of typed ahead input to be stored in IAF's FL 
for each user. 



VNCP 



40B 



Number of pots of output to be stored in IAF's FL for each 

user. 



NMFL 



60000B Defines the size of NAM's field length as used by the 

algorithm in COMPCMX. This calculation determines the field 
length available for an interactive job. This value should 
be equal to the value of MAXNIP, which defines the maximum 
field length that NAM can attain. MAXNIP is an installation 
parameter for NAM. 
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COMSRSX Parameters 

COMSRSX contains the following parameters, which are used by the resource executive. 
Assemble CALLSYS to obtain a listing of COMSRSX. The released values assume the default job 
scheduler cycle of 1 second. 



Parameter 



RPMS 



Default Value 
in Minutes 



RPOV 



SUBM 



MTMS 



10 



RFTL 



10 



Significance 

Length of time that a job waiting for an auxiliary device is 
rolled out before retrying assignment. 

Length of time that a job that has had a request for an 
auxiliary device denied because of overcommitment deadlocks 
is rolled out before retrying assignment. 

If MAGNET is not active, length of time that a noninteractive 
service class job calling RESEX is rolled out before retrying 
assignment. 

When one of the following situations prevents immediate 
assignment of the tape, MTMS specifies the length of time 
that a job requesting a tape is rolled out before retrying 
the assignment. 

• The job requests a tape with a VSN that is not 
currently available. 

• The job requests a 9-traek tape that is mounted 
without a write ring, the job requests the wrong tape 
density, and the tape hardware detects that the 
density of the tape is incompatible with the unit on 
which it is mounted (800-cpi tape on a 1600/6250-cpi 
drive or 6250-cpi tape on an 800/1600-cpi drive). 

Length of time that a job requesting a resource is rolled out 
before retrying the request when a track limit occurs on the 
resource demand or VSN files. 



MTOV 



Length of time that a job that has had a request for a 
magnetic tape denied because of overcommitment deadlocks is 
rolled out before retrying the assignment. 
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COMSSCD Parameters 

COMSSCD contains the definitions of the service classes used by NOS. Assemble CALLSYS to 
obtain a listing of COMSSCD. By default, four installation service classes are defined: 10, 
II, 12, and 13. To define additional installation service classes, add CLASS macro calls 
similar to those already present. You can also change the attributes of the defined 
installation service classes (those that are parameters on the CLASS macro). However, if 
you make any changes, reassemble all the decks that call COMSSCD. 



COMSSFS Parameters 

COMSSFS parameters are used by the MODVAL and PROFILE commands. Assemble CALLSYS to get a 
listing of COMSSFS. 

Parameter Default Significance 

FLLM 500008 Specifies the field length limit for the execution of the 

MODVAL and PROFILE commands. If the execution of a MODVAL or 
PROFILE command requires more than the specified field 
length, disk storage is used. Accessing disk storage is more 
time-consuming than accessing central memory and degrades 
performance. 



COMSSRU Parameters 

COMSSRU contains the parameters used in SRU calculations. Assemble CALLSYS to obtain a 
listing of COMSSRU. Refer to COMSSRU in the NOS 2 Analysis Handbook. 



COMSSSJ Parameters 

COMSSSJ contains the following parameters, which are used by special system jobs. Assemble 
CALLSYS to obtain a listing of COMSSSJ. The released values assume the default job 
scheduler cycle of 1 second. 

Parameter Default Significance 



ART 4 minutes Length of time that a job is rolled out while waiting for a 

direct access file to become available before trying to 
access it again. This value specifies the default for the WB 
parameter on the ATTACH command. 

FRT 15 seconds Length of time that a special system job is rolled out when a 

fast attach file is busy. 
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COMS1DS Parameters 

C0MS1DS contains the following parameter used for DSD jobs. Assemble CALLSYS to obtain a 
listing of C0HS1DS. 



Parameter 



SYSCHG 



Default 



SYSTEM 



Significance 

Micro definition that specifies the system charge number for 
jobs initiated by DSD. 



COMTNAP Parameters 

COMTNAP defines a table that maps valid network application names to the bit position of the 
access word that must be set to allow use of one or more network applications (refer to the 
description of MODVAL in the NOS 2 Administration Handbook). Assemble CALLTAB to obtain a 
listing of COMTNAP. This common deck does not contain any executable code. Each table 
entry has the following format. 



59 


17 


11 


application name (6-bit display code, 
left-justified, blank-filled) . 


reserved 


application validation 
word bit position 



Bits 17 through 12 of each entry are reserved for the program that uses COMTNAP. 
are set to when COMTNAP is assembled . The last word of the table must be 0. 



These bits 



Each application defined in COMTNAP must appear only once. However, any application 
validation bit can appear more than once; that is, a given application validation bit can be 
defined to permit use of more than one application, if the operations at a particular site 
make such a definition desirable. Bits 47 through 36 of the application validation word are 
reserved for customer application use; bits 35 through 15 are reserved for Control Data 
application use. 
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The released table defined by COMTNAP follows: 



Word 



TNAV 
TIAF 



Content* 



TLAV 



59 

IAP 

RBF 

TAF 

MCS 

TVF 

CS 

PLATO/NAM Interface 

ITF 

PSU 

reserved bit 8 

reserved bit 9 

reserved bit 10 

reserved bit 11 

API 

AP2 

AP3 



17 



11 








































1 

2 
3 
4 
5 
6 
7 
1 





12 

13 

14 



TNAV+ 
TNAVL 
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The following table-related parameters are defined In COMTNAP. All symbols are unqualified. 
Parameter Default Significance 



TNAV 



TNAVL 



17 8 



Table first word address. Program that uses COMTNAP defines 
the value. 

Table length, excluding zero-word terminator. 



COMUSIT Parameters 

COMOSIT contains the following parameters, which are used by the ASMOVE utility to control 
selection of files for destaging to the mass storage facility (MSF) and for releasing their 
disk space. Compile CALLMSS to obtain a listing of COMUSIT. Compile ASMOVE to determine 
how the following weight and scale factors are used in the selection algorithm. 

Significance 

Weight factor for MSF-pref erred residence. 

Scale factor for MSF-pref erred residence. 

Weight factor for no preferred residence. 

Scale factor for no preferred residence. 

Weight factor for file length. 

Scale factor for file length. 

Weight factor for time since last modification. 

Scale factor for time since last modification. 

Weight factor for destage control value. 

Scale factor for destage control value. 

Weight factor for minimum file length. 

Scale factor for minimum file length. 

Weight factor for maximum file length. 

Scale factor for maximum file length. 



Parameter 


Default 


DEFDB 


2 


DB$SCALE 


1.0 


DEFDC 


1 


DC$SCALE 


1.0 


DEFDL 


1 


DL$SCALE 


1.0 


DEFDT 





DT$SCALE 


1.0 


DEFDV 


24 


DV$SCALE 


25.0 


DEFMN 


6 


MN$ SCALE 


25 


DEFMX 


128 


MX$SCALE 


250 
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COMXIPR Parameters 



COMXIPR contains the following parameters used by MAS executive (SSEXEC). Assemble CALLFAS 
to obtain a listing of COMXIPR. 



Parameter 
NUMSLV 

NUMRB 

SLRP$INTV 

SLAV$INTV 



Default 



60 



Significance 

The number of slave mainframes for which master SSEXEC can 
service file staging requests. 

The number of file staging request blocks available to a 
slave mainframe. 

The number of seconds SSEXEC waits to look for new staging 
requests from slave mainframes. 

The number of seconds SSEXEC waits with no signal from a 
slave mainframe before assuming that the slave executive has 
terminated. 



PPCOM Parameters 

PPCOM contains the following parameters, which are used by system peripheral processor 
packages for intercommunication. Assemble PPTEXT to obtain a listing of PPCOM. 



Parameter 



UEBS 



ESMX 



LCOM 



LDSY 



MSMX 



Default 
100g 

51 2D 

350 8 
200D 



Significance 

Number of words in a block of user ECS (1000 8 , 2000 fl , 
4000 g ). 

Maximum number of EST entries, plus one. The value for ESMX 
can range from 10 through 512. 



Maximum length of the L-display input buffer in words, 
value for LCOM can range from 1 through 12g. 



The 



Maximum length of the L-display output buffer in words. The 
value for LDSY can range from 100g through 1000g. 

Maximum number of mass storage devices. The value for MSMX 
can range from 1 to 200. 



The assembly constant INSP$ is defined in NOSTEXT. If the INSP$ reference is deleted, 10 
bytes in both the DSD display and the command overlays are unavailable for site code. 

DSD Parameters 

The following parameters, specified in ENTER macro calls (within the DSD syntax tables), 
cause the first 25 characters of the associated DSD command to be logged in the system 
dayfile and/or the error log. The commands are logged just as they are entered by the 
operator except that the characters 

DS, 

are placed before each command. The DSD listing contains an explanation of the ENTER 
macro. Assemble DSD to obtain a listing. 



I 
I 
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Parameter Default Significance 



SDF - When specified in an ENTER macro call, the associated command 

is logged in the system dayfile. 

EEL - When specified in an ENTER macro call, the associated comnand 

is logged in the error log. On the release tapes, the OFF, 
ON, channel control, and memory commands specify ERL on their 
ENTER macro calls. 



NSS - NOS-SGOPE 2 STATION FACILITY 1 

There are no special build instructions for NSS. For information on logical mainframe 
identifiers (LIDs), refer to Remote Host Facility (RHF), later in this section. For 
information about initiating SSF, refer to Subsystem Initiation, at the beginning of this 
section. This section describes these installation options: 

• Spun-Off Task (SPOT) Memory Requirements 

• NSS Validation Requirements 

• Installation Parameters 



SPUN-OFF TASK (SPOT) MEMORY REQUIREMENTS 

The station control point MFSTAT handles all communication between the station and SCOPE 2. 
A SPOT is a job that MFSTAT initiates and places into the host mainframe input queue after 
MFSTAT detects a request for an I/O transfer or a staging operation. There are five unique 
SPOTs : permanent file SPOT, tape staging SPOT, spooling SPOT, dump SPOT, and deadstart 
SPOT. MFSTAT and all the SPOTs execute on the NOS mainframe. 

The spooling SPOT (SOT76) is the only SPOT that transfers more than one file. SOT76 is 
initiated when communication is established between mainframes and does not terminate until 
the station is dropped. All other SPOTs are initiated as required to transfer one file, and 
each is terminated after completion. 

Field length requirements fluctuate as file transfers are initiated and terminated. As file 
transfers are terminated, buffers are released. Definitions in the common deck. COMTUNE 
control the lengths of the buffers used by the SPOTs. Each SPOT uses one of the COMTUNE 
SYMPL DEFs to determine the length of the I/O buffers. All SPOTs are written in the SYMPL 
language . 

Nominal release definition octal values for the I/O buffers are described in the following 
list. 

Name Value Description 

LBUFDSTP 3004 Deadstart via tape 

LBDFDSLM 7725 Deadstart link buffer 

LBUFDP 4001 7000 dump 

LBDFLM 1401 Link medium 
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Name 



LBUFPF76 



LBUFSP 



LBUFTP 



Value 



5051 



2021 



6007 



Description 
Permanent file for 6000-7000 
Spooling 
Tape staging 



Buffers required to transfer a file vary among SPOTs. All SPOTs transfer a file between a 
N0S disk and a link medium device. For some SPOTs, this requires two separate buffers as 
data is converted. Other SPOTs use only one buffer. When two buffers are needed, the 
length of the link medium buffer is defined by LBUFLM, and the buffer for the disk is 
defined by the appropriate symbol (for example, LBUFSP for the spooling SPOT). 

Octal memory requirements for the various SPOTs are shown in table 5-9. 

SPOTs, like user jobs, may be rolled or swapped out as memory is needed. 

The relationship between buffer sizes and performance is bound by the same consideration as 
for any user job. The absolute minimum buffer size Is a PRO + 2 words. Any large reduction 
in buffer sizes from the release values has some Impact on performance. 



Table 5-9. SPOT Octal Memory Requirements 



SPOT Type 



Spooling 

Permanent 
file 

Tape 
staging tf 



Dump 



Deadstart 



Code 



10200 
5100 

6700 



4200 



6200 



Buffer Lengths Used 
to Transfer Files 



LBUFSP -tLBUFLM 
LBUFPF764LBUFLM 

3*MBL-tLBUFLM/2+3 

LBUFTP 

MBL-HBUFLM+1 

LBUFDP 

LBUFDSTP -fLBUFDSLM 



Total 

Memory 

Used 



14600 
11600 

11100 

14700 

20500 

10200 
21200 



Notest 



Single file transfer 



For MBL<(LBUFTP-LBUFLM/2-3)/3 
[7690] 

For (LBUFTP-LBUFLM/2-3 )/3 
[7690] <MBL<LBUFTP-LBUFLM-1 
[23090] 

For MBL>LBUFTP-LBUFLM-1 
[23090] 



Via tape 



TFigures in brackets are release values for the equations. 
ttThe buffer length required for tape staging depends on the value specified for the 
maximum block length (MBL) for tape staging operations. Use the equations in the Notes 
column to determine the appropriate values to use. The maximum value that can be 
specified for MBL is 50000. 
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I NSS VALIDATION REQUIREMENTS 



Add the SPOT user name entry (UN=SSPOT, PW=STATION) to the NOS validation file. This has 
been tested with the following validations, some of which may not be necessary: 



MT=7 


DF=77B 










PR=7 


SL=77B 










SC=50B 


AW=CLPF, 


CSPF, 


CCNR, CASF, 


CAND, 


CSRP, CSAP 


MS=77B 


CS 










CM=20B 


CC 










TL=77B 


CA 










CP=77B 


CA 










DB=7 


CS 










LP=77B 


CS 










CC=77B 













If you do not have a validation file, SYSGEN(FULL) automatically creates the necessary 
validations. The released user name and password are SSPOT and STATION. To change the user 
name or password, create a USER file which applies a modification set to change line: 

NSSA000.4601 
Then rerun the NSS build procedure. 



INSTALLATION PARAMETERS 

The following installation parameters are all on common deck COMTUNE on the NOS station PL. 
Deck COMTUNE also lists the minimum, maximum, and default values for these parameters. 

Table Size Parameters 

NMF The number of mainframes to which the station can be linked; the released 

value for NMF is 1, and the maximum value that can be specified is 2. 

DATAENT The maximum number of active data streams. 

SNTS The size of the SPOT name table (SNT). The size of the SNT should be the 
value of DATAENT plus the maximum number of local SPOTs (four) plus the 
spooling SPOT (one). 

IDTMAX The maximum size of the IDT table controls the number of logical IDs a 

mainframe can have and allows this value, minus two logical IDs. IDTMAX 
must match IDTL defined in PP program SSH; otherwise, SSH hangs the 
spooling SPOT until the station is dropped. 

MAXSPOTS A group of parameters that define the default maximum number of active 
SPOTs of each type that MFSTAT activates at one time. 

SPOOLS The maximum number of spooling streams. 

DISNAMESIZE The size of the display name table for the transparent display interface 
to the SCOPE 2 operating system. 

SYNTAXSIZE The size of the syntax extension table for the transparent display 
interface to the SCOPE 2 operating system. 
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Spooling and Recalling Time Parameters 

MSEC(i) Recall time in milliseconds. 

SEC(i) A method of approximating the number of busy station loops in i seconds. 

ISEC(i) A way of approximating the number of idle station loops in i seconds. 

TME7000 The delay in seconds between sending time requests to the SCOPE 2 
operating system. 

STA7000 The delay in seconds used by MFSTAT between sending status requests to the 
SCOPE 2 operating system. 

RCL7000 The recall time in milliseconds used by the busy overlay of MFSTAT when 
communicating with a linked SCOPE 2 operating system. 

TIMEOUT The length of time in seconds that MFSTAT waits before logging out a 
linked mainframe when communication is lost. 

MSGCNT The length of time in seconds that MFSTAT leaves informative messages on 
the B display. 

BSYLIM The length of time in seconds the busy overlay of MFSTAT delays after 
sensing an idle condition, before going into an idle state. 

IDLRCLTM The recall time in seconds used by MFSTAT when the idle overlay is 
executing. 



| NOTE | 

For better response time, lower both the RCL 
and STA values. To reduce CPU use, increase 
the RCL value. If the RCL and STA 
parameters are reduced too much, however, 
the reduction may cause STD (the link medium 
coupler driver) to be locked in. 



L00PL1M The delay in seconds that MFSTAT waits before checking for a change in 

busy to idle status (controls the frequency with which the busy portion of 
the station checks its busy status). 

DSDWAIT The length of time in seconds that MFSTAT waits for a reply before it 
rejects a DSD request. 

MAXINCOUNT The frequency in seconds with which MFSTAT checks the input queues for 
files to spool when it is idle. 

OVLMAX The maximum time in seconds that MFSTAT retains the secondary overlay 
field length after a load of a secondary overlay. 

IDLEMAX The elapsed time in seconds that MFSTAT waits after all spooling activity 
has completed before swapping out the spooling SPOT. 
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SPLLIM The number of seconds MFSTAT waits before going idle once spooling 
activity is completed. 

IDLETIME The number of seconds the spooling SPOT waits before trying to initiate 
spooling operations. 

IDLETIME2 The amount of time in seconds the spooling SPOT waits before initiating 
new spooling operations if output spooling is taking place. 

SPOOLRCL The recall time in milliseconds used by the spooling SPOT when there is no 
spooling activity. 



Buffer Size Parameters 

DAYBUFSIZE The size of the MFSTAT buffer for processing SPOT day files on the active 
side. 



RRBUF 



The size of the MFSTAT active transmit buffer and the linked staged packet 
buffer. 



LRGBUF The size of the MFSTAT receive buffer for the active side of the station. 

LICRBUF The length of the MFSTAT buffer used by the IAF queue utility helper. 

LBUFLM The length of the link buffer used by SPOT jobs for NOS-SCOPE 2 I/O 
spooling. 

LBUFSP The length of the disk buffer used by the spooling SPOT for NOS-SCOPE 2 
spooling of I/O files. 

LBUFPF76 The length of the disk buffer used to read and write the disk for 
permanent file transfers to and from SCOPE 2. 

The following installation parameter is on the deck HELL07: 

HELL07 Multimainframe Flag 



NOMFF 



If NOMFF is set to 1 (the release value), HELL07 supports a single 
mainframe. If multiple mainframe support is desired, NOMFF must be set 
to 0. 
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QU3 - QUERY UPDATE VERSION 3 

The installation tool SYNGEN, and the various common decks that reside on the DDL 3 program 
library, must be available for the installation of Query Update 3. Following are the unique 
parameters for QU3. 

IMF The QU3 installation procedure provides you with the option of installing 

the Information Management Facility Version 1 (IMF 1) interface. To 
install Query Update 3 with the IMF 1 interface, specify the IMF keyword 
in the call that executes the QU3 procedure. IMF 1 must be installed 
prior to installing Query Update 3 with the IMF 1 interface. (The 
installation of IMF 1 is necessary only if you select the IMF interface 
option. ) 

SRT4 To assemble code to interface with Sort/Merge 4 rather than Sort/Merge 5, 
specify the keyword SRT4 on the call to QU3. SRT4/SRT5 must be installed 
prior to installing Query Update 3 with the SRT4/SRT5 interface. 

The QU3 interface to the Database Utilities, version 1, for CRM logging is provided by 
releasing the DBU relocatable binaries needed to load the QU/CRM logging capsule, CAFLOG, on 
the permanent file tapes. SYSGEN( SOURCE) loads this file to the installation user name 
INSTALL. The QU3 installation deck contains commands to access this file and to create a 
temporary library, DBULIB, to be used at load time. The deck also contains commands to add 
the command-callable portion of DBU (DFRCV) to the PRODUCT file, thus allowing inclusion of 
DFRCV in the deadstart tape. No special definitions are required to access this interface. 
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RBF5 - REMOTE BATCH FACILITY VERSION 1 

This subsection describes the following installation options for RBF5: 
Unique Parameters 
RBF Command 
USER File Directives 
File Placement 
Verification 

UNIQUE PARAMETERS 

NOTRACE To disable log file creation for RBF5, specify the keyword NOTRACE on the 
call that executes the RBF5 procedure. 

RBF COMMAND 

RBF5 requires the following command. 

RBF2P0(MC=mc) 

Parameter Description 

MC=mc Maximum message count; specifies the maximum number of messages to be 
accumulated in the debug log file before NETREL is called. No NETREL 
call is issued if mc is 0. This parameter is optional; no NETREL call 
is issued if MC is omitted. If NETREL is to be called, a file NRF1 must 
be assigned to the control point before the command is executed. File 
NRF1 must contain a valid job record for writing to the ZZZZZDN file. 
The released RBF job skeleton record creates NRF1 from the job input 
record . 
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USER FILE DIRECTIVES 

To assemble various features into RBF, include directives of the form: 
*DEFINE name 

on file USER for the RBF5 installation job. 

name Significance When Defined 

DEBUG Code to aid in debugging and maintenance is generated. 

IMS Descriptive internal maintenance comments are included in the assembly and 
compilation listings. 

TRACE Symbolic table dumps of RBF are written to file SPITOUT when RBF fails. 
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The following parameters are defined in the common deck IP$COM. To make 
changes to these parameters, place appropriate Update directives on file USER 
for the RBF5 installation job. 



Parameter 



SEARCHTIME 



RESUMETIME 



REFRESHTIME 



Default 
(decimal) 

15 



20 



30 



Significance 

Time interval in seconds between scans of the output queue for 
remote batch files. These times are increased by 
approximately 10 seconds when the load on RBF is light and 
when most of RBF's field length is rolled out to disk. 

Time interval in seconds between receipt of the last 
interactive message and the automatic switching of the 
terminal to batch mode; should be larger than SEARCHTIME. 

Refresh period in seconds for the RBF console queue displays 
when RBF is specified on the DISPLAY command; should be larger 
than RESUMETIME. 



STATIONS 


16 


TOTDEV 


32 



ALOTIME 



600 



Maximum number of consoles. 

Maximum number of batch devices. 

Maximum field length to which RBF expands when obtaining 
buffers. If TRACE is defined, the default value is 100000; if 
TRACE is not defined, the default value is 50000. 

Time in seconds that a dial-in terminal is allowed to remain 
inactive before being timed out of RBF. A value of 
specifies that terminals are not timed out of RBF. The 
maximum value allowed is 4095. 



FILE PLACEMENT 

Execution of the SBF5 installation procedure requires a prior build of NAM and the existence 
of the NAM startup master file under the build user index. The RBF5 installation procedure 
modifies the startup master file (NAMSTRT). Because other products may require the startup 
master file, refer to NAM5 File Placement in this section to determine when and where to 
move the file. 
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VERIFICATION 

Use the following procedure to verify correct installation of RBF. 

1. Prepare the following card deck. If necessary, supply the CHARGE command. 

job command. 

USER, username , password , f amilyname . 

NOTE. +1 TOP OF PAGE+OABCDEFGHIJKLMNOPQRSTUVWXYZ 
6/7/8/9 

A multipunch in column 1 (or for HASP terminals, /*EOI in columns 1 through 5). 

2. Initiate NAM as described under NAM5 - Network Access Method. (It is assumed that 
RBF is defined as an application in COMTNAP.) 

3. Log in from the console of any network-supported terminal with at least one card 
reader and one line printer, specifying RBF as the application and any user name 
permitted to use RBF (refer to the Remote Batch Facility Reference Manual). Follow 
all commands issued in this procedure by the message transmission key for the 
terminal class you are using (ETX or SEND for many batch terminal consoles.) RBF 
responds with a header line giving the version of RBF and the date and time of 
login, followed by READY on the following line. 

4. Enter DIS. RBF displays the status of the batch devices associated with the 
terminal. 

5. Place the card deck prepared in step 1 into the input hopper of the card reader and 
initiate reading (described in the Remote Batch Facility Reference Manual). 

6. Enter the following command at the terminal console. 

GO.CRn 

n is the device number of card reader (from 1 through 7). 

7. RBF reads the job in the card reader and responds with READY. 

8. Enter DIS, PR at the terminal console. Because the system processes the job prepared 
in step 1 in little time, RBF should indicate that the job is in the print queue. 

If not, repeat this step until such an indication is received. 

9. Ready the line printer, and enter the following command at the terminal console. 

GO.LPn 

n is the device number of line printer (from 1 through 7). 

10. RBF prints the job's output on the line printer. The output consists of a banner 

page, a page with TOP OF PAGE printed on the first line of the page and the alphabet 
on the third line, and a page containing the job dayfile. 



11, 



Enter BYE to exit RBF and log off of the system. The system issues a message 
indicating the time that has elapsed since connection to RBF. 

RBF ENDED yy/mm/dd. hh.mm.ss 

RBF CONNECT TIME hh.mm.ss 
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RHF - REMOTE HOST FACIUTY VERSION 1 

This subsection describes the following installation options for RHF: 
RHF Configuration File 
RHF Procedure File 
Hardware Configuration 
Installation Parameters 
Logical Identifier Definition and Use 
Loopback Capability 
Store and Forward Capability 

RHF CONFIGURATION FILE 

You must create an RHF configuration file using the Network Configuration Statements. You 
should define the RHF configuration including all NADs, applications, and physical 
identifiers (PIDs) to be used by or accessible to RHF. Refer to the NOS 2 Analysis Handbook 
for information about creating an RHF configuration file. 



RHF PROCEDURE FILE 

The entry point of the RHF subsystem is named RHF. Therefore, you can initiate RHF without 
a procedure file by entering the DSD entry RHF. 

If you want to initiate RHF with a procedure file, create an RHF procedure file. If you do, 
that file must contain a RETURN, RHF command to return the local file RHF before the call to 
RHF. For example, 

.PROC.RHFffff,... 
RETURN, RHF. 
local site commands 
RHF. 

RHFffff can be a procedure file stored in an indirect access permanent file under the system 
user index (377777g). 

Refer to the beginning of this section for more information about subsystem initiation. 
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HARDWARE CONFIGURATION 

RHF and its applications require the same minimum hardware configuration as NOS plus a 
minimum of one 380-170 Network Access Device (NAD). NADs must not be physically connected 
on channel 0. 

Switch settings on the NAD are critical. Many switch settings (such as access code, NAD 
address, TCI enable, and so on) must be correct to obtain any response from the NAD. The 
RESYNC and CONTENTION parameters, if not set properly, can cause occasional trunk errors. 
For example, if two NADs connected by one trunk have the same RESYNC parameter, a file 
transfer in one direction may fail with a broken connection. Set the CONTENTION/RESYNC 
parameter as follows: on any given trunk, the RESYNC parameter for each NAD should be 
unique and should be less than the value (2*contention number) + 2. Refer to the 380-170 
NAD Hardware Reference Manual for further information. 



INSTALLATION PARAMETERS 



Parameter 



Description 



MAXFILEXFR The maximum number of file transfers that the Facility Interface Program 
(FIP) allows for any one application. Values may range from 1 through 10. 
Default is 4. The current definition format is: 



1 



DEF MAXFILEXFR 



22 

#4#; 



The change deletion location is in common deck COMADEF. 
an example of a parameter change. 

DEF MAXFILEXFR #5#; 



The following is 



FETBUFSIZE The number of words assigned to buffer space for each file transfer. 

Values may be zero or greater, but FIP overrides low values. The current 
definition format is as follows: 



DEF FETBUFSIZE 



22 

#3200//; 



FETBUFSIZE 

to 532 
532 to 992 
992 and up 



Assigned 
(binary) 

532 
532 to 992 
992 and up 



Assigned 
(coded) 

992 

992 

992 and up 



The default value for FETBUFSIZE is 3200, which corresponds to about 49 
PRUs. Values larger than 6400 (98 PRUs) do not increase transfer rates 
appreciably, and make job swapping more likely because of the increased 
central memory required. 



The change deletion location is in common deck COMADEF. 
an example of a parameter change: 

DEF FETBUFSIZE #28000; 



The following is 
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MLTF Initiation Procedure Parameters 

RHF uses the system procedure MLTF (maintenance error logging transfer facility) to initiate 
periodic NAD error logging. (Routine NETLOG in the MLTF procedure does the actual recording 
of NAD errors in the binary maintenance log (BML).) The parameter used by the MLTF 
procedure controls the interval length between MLTF executions. 

The default procedure definition follows: 

•PROC,MLTF,DEL=10. 

Parameter Description 

DEL=del Time in minutes between MLTF executions (0 < del < 2048), assuming a 
job scheduler cycle of 1 second. 

The change deletion location is in deck MLTFPROC. 



NAD Controlware Initialization Parameters 

A set of initialization parameters must be loaded into NAD memory along with the NAD 
controlware as documented in the 380-170 NAD Hardware Reference Manual. These parameters 
are assembled into LOADBC and are appended to all NAD controlware loads. The default values 
provide for a maximum of 25 remote NADs, 24 paths, use of all available NAD memory, and no 
NAD buffer tracing. To change any of the initialization parameters, you must modify the 
default values and reinstall LOADBC. LOADBC subroutine CNP attempts to maximize NAD memory 
use by allocating as much memory as possible to NAD buffers. This automatic allocation is 
defeated if the NAD memory size initialization parameter is set to nonzero. This parameter 
should not be changed without a thorough understanding of NAD controlware memory use. 



LOGICAL IDENTIFIER DEFINITION AND USE 

The logical identifier (LID) is the identifier used to refer to a mainframe. A user refers 
to an LID on an MFLINK command, an MFQUEUE command, a ROUTE command, a Job command, or an 
ITF prompt. 

For a successful access to or from another mainframe, both the RHF configuration and the LID 
table in CMR must be set up correctly. The other (remote) mainframe likewise must have its 
configuration and LID tables set up properly to receive or generate a successful network 
access. 

For either QTF, MFLINK, or ITF to initiate access to a remote mainframe, the LID must be 
defined and enabled in the LID table in CMR. This can be done either through the LIDCMid 
file entries or through the operator utility LIDOU (refer to the NOS 2 Analysis Handbook). 

For either QTFS or PTFS to respond to a remote mainframe request for file transfer, the 
remote mainframe's PID must be defined and enabled in RHF's configuration table as a valid 
PID for that mainframe. Likewise, the LID specified on the remote mainframe must be defined 
and enabled under that mainframe's host PID in the CMR LID table. 
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LOOPBACK CAPABILITY 

A special loopback capability is available on RHF for the use of both QTF and MFLINK. This 
capability is intended primarily for test purposes, but it may be used for other purposes 
such as files across families on the same mainframe. The loopback capability allows a file 
to be sent from the local mainframe out to a NAD and back to the local mainframe instead of 
to a remote mainframe. To use this capability, the LIDs used to specify loopback must be 
defined properly in the CMR LID table. Refer to the NOS 2 Analysis Handbook for information 
about the LIDCMid file and the LID table. 

To allow loopback, a PID entry (and associated LID and PATH entries) must be defined to 
match the local mainframe (Mxx, where xx is the machine id) in the LID and RHF configuration 
files.. The loopback path should be defined. The remote NAD specified on the PATH 
definition should have, as an address, the address of the local NAD. 

The LID to be used for MFLINK and/or QTF must be defined in the CMR LID table as enabled and 
loopback, under the mainframe host PID. 

STORE AND FORWARD CAPABILITY 

A queued file can be transferred from one mainframe to a remote mainframe that is not 
directly linked to the other mainframe. You can do this by using the store and forward 
capability. Refer to the NOS 2 Analysis Handbook for information about the LIDMCid file and 
the LID table. 
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RHP - PTF/QTF RLE TRANSFER FACILITY 

This subsection describes the following installation options for RHP: 

• Unique Parameters 

• Installation Parameters 

• QTF Initialization Procedure Parameters 

UNIQUE PARAMETERS 

SUBSYS=subsys To install the file transfer applications to interface with RHF or NAM 
or both subsystems, use the SUBSYS=subsys parameter. Here are the 
values you can specify for subsys: 

RHF 

NAM 

BOTH 

The default is SUBSYS=RHF. 

TRACE To enable AIP/FIP tracing, include the keyword TRACE on the procedure 

call. 

DEBUG To enable full debug code, include the keyword DEBUG on the procedure 

call. Unsupported code for debugging purposes when writing and testing 
RHF components is available by including the E and C parameters on all 
SYMPL compiler commands and PC=DEBUG on all COMPASS commands. This code 
is not normally compiled or assembled and is not intended for a 
production environment. 
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Table 5-10 shows the binaries that are built depending on which subsystem you have specified. 



Table 5-10. Binaries Built 





SUBSYS-RHF 


SUBSYS=NAM 


SUBSYS=BOTH 


PTF 


MFLINK 


MFLINK 


MFLINK 




FIFO 100 


FTF0300 


FTF0500 




FTF0200 


FTF0400 


FTF0600 
FTF0700 


PTFS 


PTFS 


PFTSN 


PFTS 




PFS0100 


PFS0300 


PFS0100 




PFS0200 


PFS0400 


PFSO200 
PTFSN 
PFS0300 
PFS0400 


QTF 


QTFI 


QTFIN 


QTFI 




QTF 


QTF 


QTFIN 
QTF 


QTFS 


QTFS 


QTFSN 


QTFS 




QFS0100 


QFS0300 


QFS0100 




QFS0200 


QFS0400 


QFS0200 
QTFSN 
QFS0300 
QFS0400 


MFQUEUE 


MFQUEUE 


MFQUEUE 


MFQUEUE 
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INSTALLATION PARAMETERS 

For information about MFLINK requests and auxiliary pack options, refer to the APLO parameter 
under the NOS COMSPFM deck in this manual. 



Parameter 



Description 



ACNMAXC The maximum number of connections that queue file transfer facility (QTF) 
can have active at any one time. Values can range from 1 through 10; the 
default is 4. (Lower values reduce QTF's memory requirements, but may also 
reduce the number of queue files transferred Simultaneously.) The current 
definition (acceptable to both COMPASS and SYMPL) is as follows: 

1 11 18 24 36 
#ACNMAXC #DEF# 4 #ACNMAXC #4#; 

The change deletion location is in common deck COMCAPR. An example of a 
parameter change follows. 

#ACNMAXC #DEF# 2 #AACNMAXC #2#; 

TIMEOUT The time in seconds (assuming a job scheduler cycle of 1 second) in which a 
response must be received by an application from the remote NAD /application 
before the connection is broken. Values may range from 1 through 1800 
seconds. Default is 600. The current definition format (acceptable to both 
COMPASS and SYMPL) is as follows: 

1 11 18 24 34 
#TIME0UT #DEF# 600D #TIME0UT #600#; 

The change deletion location is in common deck COMCAPR. The following is an 
example of a parameter change. 

#TIME00T #DEF# 400D #TIME0UT #400#; 

MAXRTRY The number of retries that an application attempts to successfully complete 
a file transfer using RHFAM. Values may range from 1 through 50. Default 
is 10. The current definition format (acceptable to both COMPASS and SYMPL) 
is as follows: 

1 11 18 24 34 
#MAXRTRY #DEF# 03D #MAXRTRY #03 #; 

The change deletion location is in common deck COMCAPR. The following is an 
example of a parameter change. 

#MAXRTRY #DEF# 20 #MAXRTRY #20#; 
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QTF INITIATION PROCEDURE PARAMETERS 

RHF uses the system procedure QTF to initiate the RHF application QTF. The parameter used 
by the procedure controls the interval length between QTF executions. 

The default procedure definition follows: 

.PR0C,QTF,DEL=10. 

Parameter Description 

DEL=del Time in minutes between job executions (0 < del < 2048), assuming a 
job scheduler cycle of 1 second. 

The change deletion location is in deck QTFPROC. 
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SORT - SORT/MERGE VERSION 4 

HARDWARE REQUIREMENTS 

If you use the tape sort option, polyphase requires three additional magnetic tape units and 
balanced requires four. 

USER FILE DIRECTIVES 

Whether Sort/Merge 4 uses the CMU hardware depends upon the IP.CMU parameter (refer to TEXT 
and TEXTIO, later in this section) from IPTEXT. To override this parameter, make the 
following changes on file USER. 

To install Sort/Merge 4 without CMU code (default): 

*I,FEAT64.42 

BDP.INST EQU BDP.NO 
To install Sort/Merge 4 with CMU code: 

*I,FEAT64.42 

BDP.INST EQU BDP.YES 
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TAF - TRANSACTION FACILITY VERSION 1 



For an overview of the TAF installation process* refer to the installation overview appendix 
in the TAF Reference Manual. 

This subsection describes these installation options for TAF: 

• Unique Parameters 

• Task Library 

• TAF Procedure File 

• TAF Validation Requirements 

• Installation Parameters 






UNIQUE PARAMETERS 



DEBUG 



TASKLB 



You can install TAF with or without the trace feature. To get the trace 
feature, specify DEBUG on the call to the installation procedure TAF. 

To create a task library (refer to TASK LIBRARY below), specify the keyword 
TASKLB on the call to TAF installation procedure. 



TASK LIBRARY 

Before running the TAF installation procedure, create a task library permanent file 
containing the following required tasks: 



Task 

ITASK 

BTASK 

CRMTASK 

CTASK 

RTASK 

RCTASK 

KDIS 

LOGT 

MSABT 

OFFTASK 

STASK 

SYSMSG 

XTASK 



Description 
Initial task. 

Task that recovers transactions initiated by BTRAN. 
Task that formats TAF/CRM Data Manager file status displays. 
Task to recover transactions using the TAF/CRM Data Manager. 

Task to recover terminals. RTASK may be on the task library permanent file 
or on database libraries. 

Task that recovers CDCS transactions. 

TAF K display driver. 

Task to log out transaction terminal from TAF. 

Diagnostic generator for abnormally terminating tasks. 

Inactive task controller. 

Send message then cease. 

Message task for system origin messages. 

Execute named task. 



If TAF is used in a multimainframe complex, the system does not allow concurrent access to 
the same database. A copy of TAF in each computer must have its own user name/user index or 
default family. 
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TAF PROCEDURE FILE 

Refer to Subsystem Initiation at the beginning of this section for information about the TAF 
procedure file and about subsystem initiation. 

The user name required by TAF (KB100DC) is created automatically by SYSGEN(FULL) if no 
validation file exists. 



TAF VALIDATION REQUIREMENTS 

If you have no validation file, SYSGEN (FULL) creates the necessary user names and passwords 
for running TAF — user name KB100DC and password TAFPASS under user index 16 octal. The user 
name is used by SYSGEN to install the released TASKLIB file and for TAF operations. To 
change the password, supply a USER directive in the TCF file. To change the user name or 
user index, reassemble TAF changing the USNM and TRUI micros. These micros are set in deck 
COMKIPR. If you want to use SYSGEN to load files to the user names, you must temporarily 
set the password to the default password or modify SYSGEN. 
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INSTALLATION PARAMETERS 



Unless otherwise specified, the following parameters are defined in deck COMKIPR. These 
parameters specify the charge and project numbers and user index for TAF. They also specify I 
the user name under which TAF runs. ■ 



Parameter 



CGNM 



Default 



A null micro 



PJNM 


A null micro 


TRUI 


16B 


USNM 


KB100DC 



Significance 

Micro whose string specifies the charge number for TAF; used 
when a dump is performed. If CGNM is null, no CHARGE command 
is issued, and the user name specified by USNM must not 
require a CHARGE command. 

Micro whose string specifies the project number for TAF. 
User index for TAF. 

Micro whose string specifies the user name under which TAF 
runs. 



The following parameters specify the default initialization K display options. 



Parameter 



ECSFL 



NCMB 



Default 



40 



Significance 

Extended memory field length/1000 8 . ECSFL cannot be less 
than nor greater than 400 g . 

Actual number of communication blocks allowed in the 
subsystem. Communication blocks hold incoming terminal 
input. This parameter can be changed by the initialization 
command K.CMB, but it cannot be less than 19 nor greater than 
40. 



NSCP 



SCMFL 



TLFM 



31 



37660OB 



TASKLIB 



Maximum number of subcontrol points. It cannot be less than 2 
nor greater than 31. 

Maximum field length. SCMFL cannot be less than 40000 8 nor 
greater than 376600g, and must be set to a value that can be 
attained. 

Micro whose string specifies the system task library file name. 
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The following parameters, defined in deck TAF, specify the default DSDUMP parameters. The 
user can override the parameters specified on CMDUMP requests with a task. 



Parameter 



DEXP 



DFWA 
DLWA 
DORC 
DORT 



Default 



DSQID 





100000B 

BCOT 





Significance 
Exchange package dump flag: 

Value Description 

Exchange package is not dumped. 

1 Exchange package is dumped. 

First word address in octal for task dump. 

Last word address in octal for task dump. 

Origin code. 

Output disposition (corresponds to OQ parameter on 
DSDUMP/CMDUMP requests): 



Value 

1 
2 



Description 
Local batch output queue. 
Remote batch output queue. 
Direct access permanent file. 



Refer to the TAF Reference Manual for further information. 

Batch identification (ID) code for output of jobs entered in 
the input queue by the task SUBMT request. The system assigns 
this ID to the output from jobs containing a SETJOB,DC=DF 
command. DSQID ranges from through 67g. 
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The following parameters specify default time dependencies. Although these values are 
expressed in milliseconds, they are accurate to only 1 second. 



Parameter 



Default 



CORTL 


1*1000 


ITRTL 


1500 


RRTTL 


1*1000 


TACTL 


2*60*1000 


TROTL 


10*60*100( 


DMMTL 


4 


TSKTL 


120 


The following 


parameters, 


Parameter 


Default 


DWITL 


8*60 



NESTL 
RTDNL 



16 
2*1000 



Significance 

How often TAF checks to see if memory can be released to the 
system. 

Time to wait for input before rollout of transaction executive 
field length. ITRTL is defined in deck TAF. 

Time allowed to elapse before evicting a reusable task. 

Time allowed to elapse between TAF receiving any input and TAF 
generating a call to ITASK. TACTL is defined in deck TAF. 

Duration of rollout. TROTL is defined in deck TAF. 

Time allowed to elapse between calls to the data manager(s). 

Task time slice in milliseconds. 



Significance 

Time in seconds that a task is allowed to wait for terminal 
input before aborting. The user can override this parameter 
with the WAITINP request. 

Nest limit for CALLRTN (must be less than 64). 

Number of milliseconds a task is allowed to remain in memory 
waiting for a CALLRTN to complete. 
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The following parameters specify other default TAF installation parameters. 



Parameter 



DTSTL 



IPTAR 



Default 



16 



IPTST 



RECDF 



500 



Significance 

Number of time slices for a task. The user can override DTSTL 
for an individual task with the ITL request. DTSTL is defined 
in deck TAF. 

Automatic recovery flag: 

Value Description 

Automatic recovery is disabled. 

1 Automatic recovery is enabled. 

If recovery is disabled, the following requests are not 
honored in recovery mode. 



Request 
CALLTRN 

RERUN 

RGET 

RPUT 

RSECURE 

SECURE 

TINVOKE 

TSTAT 

WSTAT 



Comments 

Transactions can be scheduled, but input is 
not logged to the communication recovery file 
(CRF). 



Except for the keywords USER and NEXT. 

Except for the keywords STEP (=8 or =9) and 
USER. 



IPTST must be 



DTYM 



Dl 



Number of terminals that can access TAF. 
greater than and less than 4095. 

Default user recovery flag: 

Value Description 

User recovery is enabled. 

1 User recovery is disabled. 

Micro whose string specifies the device type for journal files. 
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Parameter 



IFL= 



Default 



200000B 



MAXJL 

MAXRA 
MAXTO 

MAXWS 
TLDL 



2500 

500B 
6*MAXWS 

409+1 
TLDLE*10 



Significance 

Initialization field length; defined in deck TAF. This value 
must be large enough to load the Application Interface Program 
(AIP) required for NAM interface, and the desired data 
managers and various tables required by TAF during 
initialization. If the message MEMORY OVERFLOW DURING 
INITIALIZATION is issued, either increase IFL= or decrease the 
databases, the number of data manager buffers, or the number 
of communication blocks. 

Maximum word count on one journal request to any journal file, 
including header words; defined in deck TAF. 

Task limit for RA+1 requests; defined in deck TAF. 

Maximum number of words task can send to the communication 
subsystem. Reaching or exceeding this value causes the task i 
to abort. | 

Number of words SEND can transmit plus 1 . Exceeding this 
value causes the task to abort. 

Amount of space to reserve for added tasks in the TAF-resident 
copy of the directory of each task library attached by TAF. 
This space can be used when TAF is informed of a task library 
change through the LIBTASK TT option. The value of the symbol 
should be a multiple of the size of a task library directory 
entry (TLDLE, currently 3). 

The default value allows space for 10 (TLDL/TLDLE) additional 
tasks. If more than TLDL/TLDLE tasks are added by the TT 
option, only the first TLDL/TLDLE tasks can be executed. The 
next time TAF is reinitialized, however, all the tasks added 
via the TT option are available to be executed. TLDL is 
defined in deck COMKTLD. 
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CMDM 



CMMBFL 

CMMEFL 
CMMTFL 

CMMCAP 



CRMUPM 



BMAX 



RMDM 



The following parameters are used with the TAF/CRM Data Manager. 
Parameter Default Significance 

Output queue length. 

Input queue length. 

Number of CRM databases. 



AOBFL 


31 


AIBFL 


31 


CMAXDB 


31 



31 



50000B 


30000B 

35000B 



15 



Maximum number of transactions concurrently issuing TAF/CRM 
Data Manager requests and the number of segments in each 
bef ore-image recovery file belonging to TAF/CRM Data Manager. 
If you change this parameter, database recovery is not 
possible using existing bef ore-image recovery files: you must 
recreate the bef ore-image recovery files. 

Base field length in words for common memory manager (CMM) 
buffer management. 

Number of words for CMM to expand buffer management. 

The upperbound on CRM's target field length. This area within 
the CMM buffer is used by CRM data and index blocks (for more 
information, refer to appendix G of the CRM Advanced Access 
Methods Version 2 Reference Manual). 

Maximum space within the CMM buffer that CRM uses for loading 
capsules, and for internal tables plus a padding value. This 
value is used to determine whether the value of CMMBFL is set 
properly in relationship to CMMTFL and the needs of CMR based 
upon the file organizations to be used by TAF/CRM. 

Number of updates allowed. Also defines the number of records 
in each segment of the before-image recovery files. 

Number of before-image recovery files. The maximum value for 
BMAX is 63. 

Number of mainframes running TAF/CRM Data Manager. 
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The following parameters are used with TOTAL Data Manager and are defined in deck TAF. 
information on the installation of TOTAL, refer to the NOS 2 Applications Installation 
Handbook. 



For 



Parameter 



TIMDM 



Default 



10 



Significance 

Maximum number of transactions concurrently issuing TOTAL Data 
Manager requests. 



™AXDB 31 Maximum number of TOTAL databases that can be initialized. 

TMAXFIL 100 Maximum number of files per database. 
The following parameters are defined in deck COMKNWC. 



Parameter 



MLIM 



Default 



100 



NCTL 



250 



Significance 

Maximum number of words in one SEND request before a task is 
rolled out pending completion of terminal output. 

Maximum number of terminals in network communication table 
(NCT). To reduce core storage requirements, NCTL may be less 
than the total number of terminals in the network file (each 
entry requires 3 CM words). NCTL should be greater than or 
equal to the maximum number of terminals logged in at one 
time. If NCTL is exceeded, a terminal is rejected upon 
login. If the number of terminals defined in the NCTFi file 
is less than NCTL, the number of terminals in NCTFi replaces 
the value specified by NCTL. NCTL is defined in COMKIPR. 



NOTE 



The installation parameter MAXRA must be 
equal to or greater than the value for NCTL 
for successful initialization of TAF. This 
is due to the processing that CTASK must 
complete for every user during 
initialization. 
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The following parameters specify the default communication block parameters. 
Parameter 



CBDL 



CBUL 



NCBC 



NLIN 



RSCMB 



The following 
parameters. 

Parameter 



Default Significance 

57 Length of the data input area in the communication blocks. 
This parameter is in deck COMKCBD. 

9 Length of user area in the communication blocks. This 

parameter is in deck COMKCBD. 

4 Maximum number of communication blocks reserved for large 

transaction input. 

4 Maximum number of users allowed to perform large transaction 
input simultaneously. TAF reserves n - NLIN x NCBC - RSCMB 
communication blocks for smaller transaction input, n is the 
number of communication blocks with which TAF is initialized. 
NLIN should not be less than 4. 

2 Maximum reserved communication blocks for nonterminal use. 

This number is included in the NCMB parameter. 

parameters, defined in deck COMKTLD, specify the default task library 



TLDMT 



Default 



600 



Significance 

Number of tasks per library. The maximum value for TLDMT is 
1365. 



TLDMN 



TRDMN 



TRDMT 



10 



10 



300 



Number of tasks that may be added online to TAF's copy of any 
particular task library directory by the LIBTASK TT option. 

Number of transactions that may be added online to TAF's copy 
of any particular transaction library directory by the LIBTASK 
TT option. 

Number of named transactions per library. 
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The following parameters, defined in deck DMREC (except where otherwise indicated), specify 
the default batch recovery parameters. 



Parameter 
AAICL 
CRMARB 



CKMARFN 



DTTP 



EXPCT 



Default 
200 
15 



35000 



10 



FTABL 


5000 


NCOPY 


2 


NDUMP 


ioo 8 


NUMARF 


1 


TDEN 






Significance 

Number of ignore entries. 

Number of after-image records that are buffered in the CM 
buffer for the file before they are flushed to disk. Also, 
the block length for after-image recovery files (ARFs). If 
you change this parameter, you must dump and recreate all 
ARFs. This parameter is in deck COMKIPR. 

Length in physical record units (PRUs) of after-image recovery 
files. When preallocated by TAF or DMREC, the length 
specified by CKMARFN is assigned to the files excluding the 
header. This parameter is in deck C0MKIPR. 

Tape drive type definition for dumping database and 
after-image recovery files; defined in deck COMKIPR. 



Value 


1 



Description 
Seven-track tapes. 
Nine-track tapes. 



Default value of the percentage parameter for the EXPAND 
directive of deck DMREC. 

Length of intermediate ignore table used during DMREC recovery. 

Number of backup dumps to keep. 

Number of dumps or directives. NDUMP must be less than 500g. 1 

Number of duplicate ARF copies. 

Tape density for dumps; any of the following. 



Value 


Description 





System default density 


1 


556 cpi 


2 


200 cpi 


3 


800 cpi 


4 


1600 cpi 


5 


6250 cpi 



This parameter is in deck COMKIPR. 
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Parameter 



Default 



TDTR 


40 8 +10g*DTTP+TDEN 


TTIGL 


5000 


TLOGL 


100 


TVSNL 


40 


WBUFL 


4001B 



Significance 
Tape format definition. 

Length of table that contains the transaction 
entries to be ignored duuring DMREC recovery. 

Number of files in database. 

Number of VSNs allowed. 

Length in words of buffer used to contain data 
read from a block on the after-image recovery 
file. Size depends on the installation 
parameters CRMARB and CMDM, and on the maximum 
record length specified for the database files 
in the xxJ file (refer to the TAF Reference 
Manual). 
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TDU - TERMINAL DEFINITION UTILITY 

To build the TDU, you must use the SES CYBIL compiler. 
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TEXT AND TEXTK) - PRODUCT TEXTS AND PRODUCT TEXTS I/O 

General installation parameters related to the common products are defined within the common 
deck IPARAMS, included in Product Texts. 

The default values of the 1PARAMS configuration parameters are defined with the CEQU or 
CMICRO macros so that you can insert all modifications at one place. The CEQU and CMICRO 
macros define symbols conditionally; that is, they are effective only if the variables have 
not been previously defined. Therefore, any modifications you make must precede them. 
Insert all changes to IPAKAMS at IPAKAMS. 15. 

Modifications to be applied to products TEXT and TEXTIO should be applied only in the 
procedure TEXT. 

To obtain a listing of all installation parameters in IPAKAMS, run a job similar to the 
following: 

job command. 

USER , INSTALL , INSTALL . 

BEGIN, PRDIN, INSTALL ,PRDNAME=TEXT ,DISK=0 . 

UPDATE, Q. 

COMPASS, A, I, S=0. 

— eor — 

♦COMPILE IPTEXT 

— eoi — 
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UNIQUE PARAMETERS 

CSET Defines the character set to be used throughout the system. The character set 
selected determines the collating sequence to be used; that is, the order in 
which records are retrieved from a database and the results of comparisons of 
characters on a basis of greater than or less than. Refer to the CYBER Record 
Manager Basic Access Methods Reference Manual for a description of the 
collating sequences. The default value is C64. Here are the allowable values: 

C64 Selects the CDC graphic 64. 

A64 Selects the ASCII graphic 64. 

C63 Selects the CDC graphic 63. 

A63 Selects the ASCII graphic 63. 

This parameter sets the IP. CSET symbol; these products reference IP. CSET. 



AAM2 


FCL 5 


ALGOL-60 5 


FORTRAN 5 


APL2 


Sort/Merge 4 


BASIC 3 


Query Update 3 


C0B0L5 


Update 1 


COMPASS 3 


8-Bit Subroutines 1 


FCL 1 




FCL 2 





ECS This parameter specifies whether extended memory is available for use by 
Loader. Allowable values are YES and NO. The default is YES since no 
negative impacts result if extended memory is not available. If you specify 
YES, extended memory is available for use by Loader when loading user 
programs; if you specify NO, user programs loaded by Loader cannot use 
extended memory. This parameter sets the IP.MECS symbol. 

MFT This parameter selects the mainframe model type. All values of the model 

micro are supported. The default is for the CYBER 74. Here are the allowable 
values : 

71, 72, 73, 74, 171, 172, 173, 174, 175, 176, 720, 730, 740, 750, 760, 810, 
815, 825, 830, 835, 845, 855, 865, or 875. This parameter sets the MODEL, 
HF.LIST, and IP.CMU symbols; most common products reference the MODEL micro. 
If you have an 840, 850, or 860, set MFT to 855. 



|note I 

Do not add user code to set the symbols 
IP. CSET, IP.MECS, IP.CMU, MODEL and HF.LIST 
since they are set by the above parameters. 
To specify your own values for HF.LIST, 
IP.CMU, and the MODEL micro, specify MFT=0 
and apply user code to set these symbols. 
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The following list constitutes the extent of installation-changeable symbols -in IPARAMS. 

Parameter Default Significance 

IP.CMU If a value other than zero is specified, the compare/move unit 

hardware is present; if you specify zero, the compare/move 
unit hardware is not present. A value for IP.CMU is set by 
the unique parameter MFT on the call for the TEXT installation 
procedure. The following products reference IP.CMU: 

COBOL5 

Sort /Merge 4 

IP.CSET Defines the character set to be used throughout the system. 

This parameter is controlled by the unique parameter CSET on 
the call to the TEXT installation procedure. The character 
set selected determines the collating sequence to be used. 

To select the ASCII graphic 64-character set, specify a value 
of IP.C64.2 for the IP.CSET parameter. 

To select the CDC graphic 63-character set, specify the 
following two parameter definitions: 

IP.C63 EQU IP.C64.1 
IP.CSET EQU IP.C63 

To select the ASCII graphic 63-character set, specify two 
parameter definitions: 

IP.C63 EQU IP.C64.2 
IP.CSET EQU IP.C63 

The following products reference IP.CSET: 

AAM2 FCL 5 

ALGOL-60 5 FORTRAN 5 

APL2 Sort/Merge 4 

BASIC3 Query Update 3 

C0B0L5 Update 1 

COMPASS 3 8-Bit Subroutines 1 

FCL 1 

FCL 2 
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Parameter 



Default 



Significance 



MODEL 



This parameter, which selects the mainframe model type, is 
controlled by the unique parameter MFT on the call to the TEXT 
installation procedure. All values of the model micro are 
supported. The default is for the CYBER 74. Here are the 
allowable values: 



71, 72, 73, 74, 171, 172, 173, 174, 175, 176, 720, 730, 740, 
750, 760, 810, 815, 825, 830, 835, 845, 855, 865, or 875. 
This parameter sets the MODEL symbol; most common products 
reference the MODEL micro. 



IP.MECS 



OS. ID 



NOS 2.4.1 



If you specify a nonzero value, extended memory is available 
for use by LOADER when loading user programs. If you specify 
zero, user programs loaded by LOADER cannot use extended 
memory. This parameter is controlled by the unique parameter 
ECS on the call to the TEXT installation procedure. 

System identification micro for displaying the operating 
system name and version number in generated program binaries. 
Most common products reference the OS. ID micro. 
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Parameter Default Significance 

HF.LIST Micro whose value specifies the presence of certain hardware 

features in the configuration on which the products are being 
used. You should supply HF.LIST in addition to the MODEL 
micro, since use of various hardware features by the products 
is conditional on HF.LIST. However, if you do not define 
HF.LIST, the system selects a default value that is based on 
the MODEL micro and assumes no optional hardware. The default 
HF.LIST is a temporary capability that will be removed in a 
future release. You can define the following entries in 
HF.LIST. 

Entry Description 

C Compare/move unit (CMD) hardware is present. 

L For model 176, LCME is present. 

For models 810, 815, 825, 830, 835, 840, 845, 
850, 855, 860, 865, and 875, UEM is present 
only if defined during deadstart. 

Both LCME and UEM are kinds of memory for 
which direct access instructions (014 and 015) 
are defined. 

Sn Stack size; n specifies the size of the 

longest possible instruction stack program 
loop in words. If the mainframe being 
described has no stack, omit this entry, n 
can be either of the following. 

7 74 and 6600 

10 175, 176, 740, 750, 760, 865, and 
875 
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Parameter Default Significance 

Entry Description 

Px Type of central processor; x can be one of the 
following values. 

S 6200, 6400, 6500, 71, 72, 73, 171, 
172, 173, 174, 720, 730, 810, 815, 
825, 830, 835, 840, 845, 850, 855, 
and 860; serial type CPU, etc. 



74 


6600, 6700, and 74 


175 


175, 740, 750, and 760 


176 


176 


740 


740 


750 


750 


760 


760 


865 


865 


875 


875 



The processor type defaults to PS if HF.LIST 
is defined but the processor type is omitted. 

PSD The central processor's exchange package contains a PSD 

register; model 176 only. 

CRW Central memory read/write operations are performed for 660/670 

instructions; models 810, 815, 825, 830, 835, 840, 845, 850, 
855, 860, 865, and 875. 
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Here are the default values selected for the HF.LIST parameter as set by the unique 
parameter MFT on the call to the TEXT installation procedure: 



MODEL 
Micro Value 

71 

72 

73 

74 

171 

172 

173 

174 

175 

176 

720 

730 

740 

750 

760 

810 

825 

830 

835 

855 

865 

875 

Any other 



HF.LIST 
Default String 

PS 

C,PS 

C.PS 

P74.S7 

PS 

C.PS 

C.PS 

C,PS 

P175.S10 

P176.S10.L 

C,PS 

C,PS 

P740.S10 

P750.S10 

P76.S10 

C,PS,CRW,L 

C.PS.CRW.L 

C,PS,CRW,L 

PS,CRW,L 

PS,CRW,L 

P865,S10,CRW,L 

P875,S10,CRW,L 

PS 



Duplicate parameter entries (such as two Px entries) are not allowed. 

When defining HF.LIST for products intended to be run on more than one mainframe, you can 
use the central processor type PS, P74, or P175 and include stack size (even if some of the 
mainframes do not have a stack). You must not include C and L unless those features exist 
on all of the mainframes in the configuration. The resulting products do not necessarily 
perform optimally on any one of the mainframes, but they perform better on a parallel 
processor (such as a 175) if that processor type is set in HF.LIST. 
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UPDATE - COMMON MEMORY MANAGER VERSION 1 , CYBER COMMON UTILITIES, 
AND UPDATE VERSION 1 

The following Update features are available through assembly options. You can modify them 
by deleting the appropriate entry in the range UPDATE. 703 through UPDATE. 711. An attempt to 
use these features when the option is not assembled causes Update to issue error messages. 
For example, when PMODKEY is not set, the PULLMOD statement is not recognized as a legal 
directive. 



Parameter Default Significance 

DECLKEY Enabled Enables DECLARE directive. 

CHAR64 Enabled Declares 64-character set Update program library output. 

PMODKEY Enabled Enables PULLMOD statement and G option. 

AUDITKEY Enabled Allows audit functions. 

EDITKEY Enabled Allows merge and edit functions . 

OLDPLKEY Enabled Enables Update to read both old-style and new-style old 

program libraries . 

EXTOVLP Enabled Enables detection of four types of overlap involving two 

or more cards in a correction set. 

DYNAMFL Enabled Declares dynamic table expansion. When this option is 

assembled , Update automatically expands tables as required 
and dynamically requests NOS to change the user field 
length to accommodate the additional table area. At the 
end of the run, the field length is reduced to that 
requested by the user. 

Common Memory Manager (CMM) uses symbol definitions from common deck CMMCOM. The symbols 
defined in IPTEXT that specify the operating system are also used. You can change the 
following CMMCOM installation parameters for CMM. 



Parameter 



DEFVER 



Default Significance 

Defines which of two versions of CMM is to be used by 

default . 



FLF 



FLINC 



2000B 



2000B 



Value Parameter 

A version without error checking (FAST) is 
used. 

1 An error checking version (SAFE) is used. 

When variable block code is not present (only fixed blocks 
exist), this value is used as a default by the field 
length reduction algorithm. The amount of free space 
above the highest fixed block is reduced to FLF central 
memory words. 

when field length is increased by CMM, this value is used 
as a default increase above the minimum amount needed. 
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XEDIT - XEDIT VERSION 3 

Store the file XEDITH under user name LIBRARY. Use the SYSGEN(MOVE) utility (refer to 
appendix B) to move XEDITH. You must run SYSGEN(MOVE) at the system console. 
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GLOSSARY 



Account Dayflle 

The account dayfile provides a history of system usage. It also provides information 
necessary for accurate billing and system usage and analysis. 

APRDECK 

The APRDECK (Auxiliary Mass Storage Parameter Deck) is a text record on the deadstart 
file. The entries in this deck specify flawed disk areas. A flawed area is one that 
cannot be read from or written to by the system. 

ASCII 

American National Standard Code for Information Interchange. The standard character set 
and code used for information interchange between computer systems. 

Auxiliary Device 

Mass storage device that is not part of a permanent file family. Auxiliary devices can 
contain direct or indirect access permanent files. 

CDCS 

Refer to CYBER Database Control System. 

Central Memory (CM) 

The main storage device whose storage cells (words) can be addressed by a computer 
program and from which instructions and data can be loaded directly into registers. 

Central Processor Unit (CPU) 

The high-speed arithmetic unit that performs the addition, subtraction, multiplication, 
division, incrementing, logical operations, and branching instructions needed to execute 
programs. 

Channel Number 

The number of the data channel on which a peripheral device controller can be accessed. 

Character 

Unless otherwise specified, references to characters in this handbook are to 7-bit ASCII 
code characters. 
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Checkpoint 



The process of writing to a magnetic tape or mass storage file a copy of your job's 
central memory, the system information used for job control, and the names and contents 
of all assigned files that are identified in a CHECKPT request. 



CMRDECK 



The CMRDECK (Central Memory Resident Deck) is a text file on the deadstart file. The 
entries in this deck describe the central memory table sizes to be used by the system; 
this deck also specifies which EQPDECK, IPRDECK, APRDECK, and LIBDECK will be used by 
the system. 



Cold start 



Procedure used to deadstart if the tape or disk controller has not yet been loaded with 
controlware or the controlware is not running. 

Command 

A sequence of words and characters that call a system routine to perform a job step. A 
command is sometimes called a control statement. 

Communication Line 

A complete communication circuit between a terminal and its network processing unit. 

Communication Network 

The portion of the total network comprising the linked network processing units. The 
communication network excludes the host computer and terminals and is approximately 
equivalent to the set of all network elements configured as part of the total network. 

Communications Supervisor (CS) 

A portion of the network software, written as an application program, that coordinates 
the network-oriented activities of the host computer and of the lines and terminals 
logically linked to it. 

Control Point Number 

The number of the control point to which a job is assigned while the job resides in 
central memory. The actual number of control points is an installation parameter. 
Before the job can execute, each central processor program must be assigned a control 
point . 

Control Statement 

Refer to Command. 
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Controller 

Hardware device that connects channels to peripheral devices. For example, a tape 
controller might connect up to eight tape units to one channel. 

CPU 

Refer to Central Processor Unit. 

CS 

Refer to Communications Supervisor. 

CTBER Database Control System (CDCS) 

The DMS-170 controlling module that provides the interface between an application and a 
data base. 

Data Channel 

One of the 9 to 24 channels (12-bit) by which information passes between the peripheral 
processors and peripheral devices. Refer to Channel Number. 

Day file 

A chronological file created during job execution which forms a permanent accounting and 
job history record. Dayfile messages are generated by operator action or when commands 
are processed. A copy of the dayfile is printed with the output for batch jobs. You 
must explicitly request it in an interactive job. 

Deads tart 

The process of initializing the system by loading the operating system library programs 
and any of the product set from magnetic tape or disk. Deadstart recovery is 
reinitialization after system failure. 

Deadstart Sequencing 

The execution of a selected set of commands before normal system job scheduling is 
enabled. 

Default Value 

A fixed value supplied by the system for a missing parameter. 
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Detached Job 

An interactive service class job removed from control of the interactive subsystem. It 
may or may not continue to execute, depending on the presence of commands in the command 
buffer or an active job step. Control is regained by recovering the EJT entry for the 
job. 

Direct Access File 

A NOS permanent mass storage file that can be attached to your job. All changes to this 
file are made on the file itself rather than a temporary copy of the file (compare with 
Indirect Access File). 

DIS (Job Display) 

A system peripheral processor program similar to system display (DSD) program. DIS 
provides communication between a job in central memory and the operator at the console, 
and permits the operator to control execution of the program through the console 
keyboard . 

Disk 

A unit composed of one or more flat, circular plates with magnetic material on both 
sides that is used to store large amounts of data or programs. 

Disk Pack 
| A group of disks with magnetically encoded information. 

Display Code 

A 6-bit character code set used to represent alphanumeric and special characters. 

Displays 

Two console screens or a split screen used to display system and job information, 
operator messages, and contents of central memory. Through the console keyboard, the 
operator can control the operation of the system. The displays are identified by 
alphabetic characters; some used frequently are the job status (B), system files (H), 
and dayfile messages (A). 

| Disposition Code (DC) 

A 2-character mnemonic indicating the destination queue and format for processing a file 
named on a ROUTE function. 
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DSD (Dynamic System Display) 

The operating system program that provides communication between the operator and the 
system by accepting control information typed on the console keyboard and by displaying 
information pertinent to all jobs known to the system. DSD is permanently assigned to 
peripheral processor 1 . 



ECS 



Extended Core Storage. Refer to Extended Memory. 

EQPDECK 

The EQPDECK (Equipment Deck) is a text file on the deadstart file. The entries in this 
deck describe the hardware connected to your computer. These entries are used by the 
system to build the equipment status table (EST). 

Equipment Number 

A number from to 7 which identifies the setting on a peripheral device controller. 

Equipment Status Table (EST) 

A central memory resident table listing all defined equipment, parameters affecting 
their operation, and the status of the equipment. 

EST 

Refer to Equipment Status Table. 

EST Ordinal 

The number designating the position of an entry within the equipment status table (EST) 
established at each installation. Devices are identified in operator commands by EST 
ordinals. 

Extended Core Storage (ECS) 

Optional additional memory. ECS contains 60-bit words; it has a large amount of storage 
and fast transfer rates. ECS can be used only for program and data storage, not for 
program execution. Special hardware instructions exist for transferring data between 
central memory and ECS. 

Extended Memory 

An extension to central memory which is physically located outside of the machine. Also 
referred to as extended core storage (ECS), extended semiconductor memory (ESM), large 
central memory (LCM), or unified extended memory (UEM). 
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Family Device 

Mass storage permanent file device associated with a specific system. A family may 
consist of 1 to 63 logical devices. Normally, a system runs with one family of 
permanent file devices available. However, additional families may be introduced during 
normal operation. This enables users associated with the additional families to access 
their permanent files via the alternate family. 

Family Name 

A designation that the installation may give to a group of permanent file devices. 

| Family Ordinal 

An index into the family ordinal table (FOT). The family ordinal is used to identify a 
unique family. 

Family Ordinal Table (FOT) 

A central memory resident table used to associate family names with family ordinals. 

| Field Length (FL) 

The area in central memory allocated to a particular job. The only part of central 
memory that a job can directly access. 

File 

1. A set of information that begins at beginning-of -information (BOI), ends with 
end-of-information (EOI), and can be referenced by a local file name. 

2. That portion of a multiple file terminated by an end-of-file (EOF). 

3. Data recorded on a magnetic tape beginning after HDR1 label and ending before an 
E0F1 label. 

I 

FOT 

Refer to Family Ordinal Table. 

IAF 

Refer to Interactive Facility. 
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Indirect Access File 

A NOS permanent file that you access by making a temporary copy of the file (GET or OLD 
commands). You create or alter it by saving or substituting the contents of an existing 
temporary file (REPLACE or SAVE commands). Compare with Direct Access File. 

Interactive Facility (IAF) 

An application that provides a terminal operator with interactive processing 
capability. The interactive facility makes terminal input/output and file input/output 
appear the same to an executing program. 

Interactive Origin Job 

A job initiated from an interactive (time-sharing) terminal. 

Job Sequence Name (JSN) 

The unique system-defined name assigned to every executing job or queued file. The JSN 

is a string of 4 alphanumeric characters, or, if the job is a subsystem, 3 alphanumeric I 

characters. I 

Job Status 

A job attribute kept in the job's executing job table (EJT) entry. It is used by the 
system to determine if a job is rolled in or rolled out. If a job is rolled out, job 



status indicates why it was rolled out 



JSN 

Refer to Job Sequence Name. 

LCF 

Refer to Local Configuration File. 

LCN 

Refer to Loosely Coupled Network. 

LID 

Refer to Logical Identifier. 

Local Configuration File (LCF) 

A file in the host computer system containing information on the logical makeup of the 
communication elements of the host. The file contains a list of the application 
programs available for execution in the host computer, and the users that can access 
it. This is a NOS direct access permanent file. 
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Local NPU 

An NPU that is connected to the host via a coupler. A local NPU always contains a host 
interface program (HIP) for processing block protocol transfers across host/local NPU 
interface. 

Logical Identifier (LID) 

A 3-character alphanumeric string used to identify a particular mainframe. LIDs are 
identified by your site. 

Login 

The procedure used to gain access to the system. 

Logout 

The procedure used to end a terminal session. 

Loopback 

A software capability by which data flow from a mainframe to the network "loops back" to 
the mainframe. This allows testing on a single mainframe with one network access device 
(NAD). 

Loosely Coupled Network (LCN) 

A network of physically connected computer systems. The LCN environment allows jobs, 
data files, and messages to be transmitted from one computer system to another. 

Machine Identifier (MID) 

A 2-character identifier used to associate a specific machine with its access to a 
shared device. 

MAG 

Magnetic tape subsystem. 

Mass Storage 

The equipment used to hold temporary and permanent files within the system. 

Mass Storage Device 

An extended memory or disk unit which has defined logical attributes such as family, 
file residency, and so on. 
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Mass Storage Table (MST) 

Table that contains an entry for each logical device in the configuration of mass 
storage devices currently available to the system. 

MID 

Refer to Machine Identifier. 

MST 

Refer to Mass Storage Table. 

Multimainf rame System 

Network of physically and logically connected computer systems. 

NAD 

Refer to Network Access Device. 

NAM 

Refer to Network Access Method. 

NCF 

Refer to Network Configuration File. 

NDL 

Refer to Network Definition Language. 

Network 

An interconnected set of network elements consisting of a host and one or more NPUs and 
terminals. 

Network Access Device (NAD) 

The primary element in a loosely coupled network. Each NAD connects a computer system 
to the network. 
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Network Access Method (NAM) 

A software product that provides a generalized method of using a communications network 
for switching, buffering, queuing, and transmitting data. NAM is a set of interface 
routines used by a terminal servicing facility for shared access to a network of 
terminals and other applications, so that the facility program does not need to support 
the physical structures and protocols of a private communications network. 

Network Configuration File (NCF) 

A network definition file in the host computer. This file contains information on 
network elements and permissible linkages between them. The status of the elements 
described in this file is modified by the NPU operator in the course of managing the 
network. This is a NOS direct access permanent file. 

Network Definition Language (NDL) 

The compiler-level language used to define the network configuration file and local 
configuration file contents. 

Network Processing Unit (NPU) 

The collection of hardware and software that switches, buffers, and transmits data 
between terminals and host computers. 

Network Supervisor (NS) 

A portion of the network software, written as a network access method (NAM) application 
program, which dumps and loads network processing units (NPUs) upon request. 

Network Validation Facility (NVF) 

A portion of the network software, written as a NAM application program, which performs 
application validation and all connection validation processing and supports login 
dialogue with the terminal user. 

NPU 

Refer to Network Processing Unit . 

NS 

Refer to Network Supervisor. 

NVF 

Refer to Network Validation Facility. 
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Order-Dependent 

Used to describe Items which must appear in a specific order. 

rder-I ndependent 

Used to describe items which need not appear in any specific order. Parameters, 
particularly those with keywords, may be order-independent. 

Origin Type 

A job attribute that indicates how a job entered the system. The four origin types are 
interactive origin, batch origin, remote batch origin, and system origin. 



OUTPUT 



The system-defined file which, by default, contains all the ouput from job processing. I 
It is also known as the print or punch file. 



Peripheral Microcode 



Special type of software that resides in a peripheral controller. The controlware 
defines the functional characteristics of the controller. 

Peripheral Processor (PP) 

The hardware unit within the host computer that performs physical input and output 
through the computer ' s data channels . 

Peripheral Processor Unit (PPU) 

First-level peripheral processor (FLPP). A PPU is contained in the mainframe in a 
multimainframe environment and operates synchronously with the mainframe. 

Permanent File 

A mass storage file that is catalogued by the system so that its location and 
identification are always known to the system. They are protected by the system from 
unauthorized access according to privacy controls specified when they are created. 

Physical Identifier (PID) 

The unique 3-character identifier of a specific host. 

PID 

Refer to Physical Identifier. 
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pp 

Refer to Peripheral Processor. 

PPU 

Refer to Peripheral Processor Unit. 

Procedure 

A user-defined set of instructions that can be referenced by name. The instructions 
consist of procedure directives and system commands. 

Procedure File 

A file containing one or more procedures. 

Queue Priority 

An attribute associated with input and output files. If all other factors are equal, 
queue priority is used to select the best file for processing. 

Queued File 

An input, print, plot, or punch file that has an entry in the queued file table (QFT), 
It is not assigned an EJT entry and is waiting to be selected for processing. 

QFT 

Refer to Queued File Table. 



Queued File Table (QFT) 



led File Table (.QFT; 

A central memory resident table containing a 4-word entry for all active input and 
output queue files. 

RBF 

Refer to Remote Batch Facility. 

Remote Batch Facility (RBF) 

A network application that provides a terminal operator with remote batch processing 
capabilities. RBF transfers input and output files between remote batch devices and NOS. 

Remote Batch Job 

A job submitted from a remote batch terminal. 
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Remote Host Facility (RHF) 

A central processor program that executes at a system control point. It performs data 
buffering and switching and is the intermediary between application programs and the 
network. 

Remote NPU 

A network processing unit linked to a host computer through other network processing 
units . 



RHF 



Refer to Remote Host Facility. 



Rollout 

The removal of jobs from central memory to mass storage before execution is complete, so 
the control point and central memory can be assigned to another job. A job is rolled 
out when it is waiting for an external event, when its control point is needed by a 
higher priority job, or when it exceeds its central memory time slice. 

Rollout File 

A file containing a job (and system information) that has been temporarily removed from 
the main processing area of the system. 

Scheduling Priority 

An attribute associated with an executing job available for job scheduling. Scheduling 
priority is used to select the best executing service class job for processing. 

SC 

Refer to Service Class. 

Service Class (SC) 

An attribute associated with a queued file or executing job. Service class determines 
how the system services the job. 

Store and Forward 

A software capability by which data flows from a network through a mainframe (store and 
forward mode) and into another network. 
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Suspended Job < 

An Interactive job placed in an inactive state. Processing is stopped imnediately and 
recovery information is copied to the rollout file. Processing is resumed as if no 
interruption took place, if the job's EJT entry is recovered. 

SYSLIB 

Refer to System Library. 

System Job 

A job brought to a control point by the operator. 

System Library (SYSLIB) 

The collection of tables and object language programs residing in central memory or on 
mass storage which are necessary for running the operating system and its product set. 

System Origin Job 

A job entered at the system console. 

TCU 

Refer to Trunk Control Unit. 

Trunk 

The communication line connecting two network processing units. 

Trunk Control Unit (TCU) 

The hardware part of a network access device (NAD) that interfaces with a network trunk. 

UJN 

Refer to User Job Name. 

Unit Number 

The setting of a hardware device. Used when more than one hardware unit can be 
connected to a controller. 

User Job Name (UJN) 

A 1- to 7-character alphanumeric name you specify to replace the system-defined job 
sequence name (JSN) for a queued file or executing job. 
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Volume Serial Number (VSN) 

A 1- to 6-character identifier that identifies the volume of magnetic tape to the system. 

VSN 

Refer to Volume Serial Number. 

Warms tart 

Procedure used to deadstart if the tape or disk controller is loaded and the controlware 
is running. 
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INSTALLATION COMMANDS, PARAMETERS, AND PROCEDURES B 



The following commands, parameters, and procedures used during installation are detailed in 
this appendix: 

• COMMOD file parameters 

• DECKLIS procedure 

• Disk installations 

• GENDST procedure 

• MISCGET procedure 

• REPORT procedure 

• RESETP procedure 

• SETUP procedure 

• SYSGEN command 
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COMMOD FILE PARAMETERS 

The installation procedures in DECKOPL contain two types of parameters: those that are 
unique to a specific installation procedure and those that are common to all installation 
procedures. 

DECKOPL is released with a default value set for all of the common parameters. These 
defaults are in a modification set file named COMMOD. When you use the SETUP procedure to 
apply the modification set in file COMMOD against DECKOPL, SETUP sets all the default 
parameters in the INSTALL procedure file. 

The COMMOD file is created automatically by the SYSGEN (SOURCE) function. Also refer to 
SYSGEN( SOURCE) and COMMOD Procedure in this appendix. 



NOTE 



The COMMOD file parameters you must change 
to perform a disk installation are described 
later in this appendix. 



If you want to change the values for any of these parameters, follow these steps: 

1. Edit the file COMMOD using an available editor. 

2. Change the parameters values for your site. 

3. Replace file COMMOD. 

4. Use the SETUP procedure to build a new INSTALL file from DECKOPL that contains your 
modifications to COMMOD. For example: 

BEGIN , SETUP , INSTALL ,MOD=COMMOD , INSTALL. 

The following pages describe the parameters in file COMMOD. 

I D=option (called from common deck COMDEN) 

Specifies the tape density. The default value is PE. 

HI 556 characters per inch (cpi) (7-track). 

HY 800 cpi (7-track). 

HD 800 cpi (9-track). 

PE 1600 cpi (9-track). 

GE 6250 cpi (9-track). 



1 NOTE | 

This parameter only affects tape requests 
for deadstart tape and density for output 
PLs when DISKINS-NO and OUTPRD=YES. 
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DISKINS (called from common deck COMDISK) 

Controls the type of installation. The default is DISKINS=NO. 



NO 



Magnetic tape installation. This option keeps as many files on tape as 
possible. Only the composite OPL and the CCP/CROSS permanent files are kept 
on disk. 



YES Disk installation; if you want to use auxiliary disk packs, additional 

parameters relating to disk pack name and type must be changed from the zero 
defaults. Refer to Disk Installations, later in this appendix. 



IA (called from common deck COMIA) 

Specifies how an installation job is submitted for execution. If you do not specify the 
keyword IA, the installation procedure submits a batch job for execution except if the 
job origin type is BCOT (local batch). For batch origin jobs, the build procedure does 
not submit another batch job. 

If the job origin type is not batch, you can specify the keyword IA to cause immediate 
execution of a build job. Specifying IA also causes the following: 



• 



If the job origin type is interactive (as opposed to running under DIS), the 
file OUTPUT is assigned to mass storage and at job completion or abnormal 
termination is renamed IAOUT. 

If you want to assign the output back to the user's terminal rather than mass 
storage, enter this command: 

ASSIGN, TT, OUTPUT. 

The build procedure issues a LIBRARY , GLOBAL command when the job is finished 
executing. This causes the local file GLOBAL (if one exists) to be made the 
global library. This feature allows you to have your own global library named 
GLOBAL in effect at a terminal to run build jobs, and to have GLOBAL remain in 
effect after the build jobs are completed. 



ICHG (called from common deck COMIUN) 

Specifies the valid charge and project number values for the installation user name. 
Here is a sample value that causes the command CHARGE (1 187, 594N321) to be executed: 

*N=$1187,594N321$. 

IFAMILY (called from common deck COMIUN) 

Specifies the default value for the alternative family name. Set this value if you are 
not installing on the system default family. This parameter is significant only if 
IUCHG— YES» 
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I IPW (called from conimon deck COMIUN) 



Specifies the password for IDN (Installation user name). The default password is 
INSTALL. The password is used by SUBPROC. This parameter is significant only if 
IUCHG=YES. 

IUCHG (called from common deck COMIUN) 

Controls the source of USER and CHARGE commands for batch job submittal. The default 
value is YES. 

YES The parameter values specified by IUN, ICHG, IPW, RESOUR, and PACKNAM are 
used to generate a USERCHG file. 

NO You must create a USERCHG file (containing appropriate USER, CHARGE, 

RESOURC, and PACKNAM commands) for the build jobs. The file can be local, 
direct, or indirect. 



| IUN (called from common deck COMIUN) 



Specifies the installation user name. The default installation user name is INSTALL. 
This parameter is significant only if IUCHG=YES. 

LIST=filename (called from common deck COMLIST) 

Specifies the file for assembly or compilation listing output. If filename is OUTPUT, 
the listing is printed with the installation listing. If you specify any other 
filename, use the TOLIST parameter to specify the destination for the output file. 
Also, the file cannot be a magnetic tape file if the installation procedure uses the 
FORTRAN compiler. 



NOTE 



A different LIST parameter, called from deck 
COMCCPL, is used for CCP build procedures. 
Refer to section 5 for information about 
CCP /CROSS installation parameters. 
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OUTPRD (called from common deck COMDISK) | 

Controls the production of output program libraries in installation jobs. The default 
is NO. 

YES The build jobs write output program libraries. This does not apply to 

MODOPL or CCP. If OUTPRD=YES and DISRTNS=NO, output program libraries are 
written to a RECLAIM dump tape with VSN=OUTPLS. All output program 
libraries are written to this tape (or multiple tapes with this volume 
serial number [VSN]). 



NO 



Output program libraries are not generated or written. 



Tnote I 

If you do not apply user code to change 
program library common decks for those 
products also used as auxiliary PLs and you 
do not want to write output PLs, you can use 
the following parameter settings: 

OUTPRD=NO 
PSRIN=nnn 
PSROUT=nnn 

nnn defaults to the current release level. 
The input PLs are then used as auxiliary PLs 
and no product output files are written. 
Binaries are still stored in file PRODUCT. 
The released DECKOPL has the parameters set 
in this manner. 



PCKNAM (called from common deck COMIUN) 

Specifies the pack name and type if all files used in the installation process are to 
reside on an auxiliary disk pack. The entry format is (*N=$PACKNAM,pname/R=typr.$). 
The default is *. This parameter is significant only if IUCHG=YES. 

PRID (called from common deck COMPRID) 

Specifies the printer identification for routing print files from verification jobs. 

PSRIN (called from common deck COMIN) 

Specifies the 3-digit number identifying the PSR level of this release. The default is 
the current release level. 
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I PSROUT (called from common deck COMOUT) 



Specifies the 3-dlglt number identifying the PSR level which is appended to the 
requested file name for the output PL files. The default is the current release level. 
If you do not change this value and OUTPRD=YES, the output PLs will overwrite the input 
PLs. 

RESOUR (called from common deck COMIUN) 

Specifies the format of the RESOURC command to use; for example, RES0URC(DJ=1 ,QE=1). 
This parameter is significant only if IUCHG«YES. 

| TOBLD=option (called from common deck COMTOB) 

Specifies the build listing disposition and determines whether the job OUTPUT goes to 
the wait queue. The default is TOBLD=NO. 

YES Job output (everything on file OUTPUT) is placed in the wait queue with a 
user job name the same as the Installation procedure name, followed by the 
letter B (for example, AAM2B). If the procedure name is 7 characters, the 
last character is replaced by B. 

NO Job output is printed at the central site, which is also the disposition if 
the job fails. 



[NOTE | 

The procedure JOBPASS and JOBFAIL contain 
inactive code that suggests how to handle 
files in the wait queue. 



| TOLIST=option (called from common deck COMTOL) 



Specifies the assembly list file routing and whether file LIST goes to the wait queue. 
The default is TOLIST=N0; if the job fails, the list file is discarded. 

YRS The file named in the LIST=filename parameter is routed to the wait queue; 
the user job name is the same as the installation procedure name, followed 
by the letter L (for example, AAM2L). If the procedure name is 7 
characters, the last character is replaced by L. 

NO The list file, if defined, is local to the job and is discarded when the job 
terminates. 



| NOTE | 

When you route listings to the wait queue, 
these files are counted in the total number 
of jobs validated for your user name. Also, 
if you want to specify different options for 
the LIST, TOBLD, and TOLIST functions, you 
can recode the procedures named JOBPASS and 
JOBFAIL in DECKOPL. However, procedures do 
not apply to CROSS and CCP installations. 
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UNI (called from common deck COMDISK) 

Specifies the alternative user name for input source files. Set UNI to a value only if 
you are rebuilding under a user name other than IUN. The default value is 0; it 
specifies that the user name under which the job is executing is used. 



|~NOTE| 

If you specify a user name for UNI, DISKINS 
must be set to NO if the source program 
libraries have not been preloaded. 



UN2 (called from common deck COMDISK) 

Specifies the alternative user name for output source files. The default is to store 
the files using the same user name as the job is executing under. 



| NOTE | 

If you specify a user name with the UN2 
parameter, OUTPRD must be set to NO. 



VFYTAPE (called from common deck COMDEN) 

This parameter only affects copying deadstart tapes. Specifies verifications of all 
tape transfers; default is verification. Use the following setting to eliminate 
verification: 

(*N=) 
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DECKLIS PROCEDURE 

The DECKLIS procedure lists the installation and support procedures on DECKOPL. Here is the 
format for the DECKLIS procedure call: 

| BEGIN.DECKLIS, INSTALL, param,param,...,param. 

There are two types of parameters: keyword=value and keyword. 

KEYWORD=VALUE PARAMETERS 



f NOTE \ 

Include all the keyword=value parameters 
before using the keyword parameters. 



REP=n Specifies the number of additional copies to be printed. The default is 0. 

H0D=fn Specifies the name of a modification set file to be added to the PL for 
listing purposes. The file can be a local file or a direct or indirect 
access permanent file. The PL is not permanently updated. 

EXPAND=nn Specifies whether common deck calls will be expanded. You can specify YES 
or NO. The default is YES. 



KEYWORD PARAMETERS 

MODIF Includes the default Modify list options on the listing. 

UMODE Lists only modified decks; used in conjunction with the M0D=fn parameter. 
NODATA Suppresses expansion of data sections for verification jobs. 
Here are some examples of calls to the DECKLIS procedure: 
BEGIN , DECKLIS , INSTALL , M0D=C0MM0D , UMODE . 
BEGIN .DECKLIS , INSTALL , NODATA . 
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DISK INSTALLATIONS 

If you want to perform your Installation with the source program libraries on disk allowing 
the installation procedures to manage disk files for you, change the DISKINS parameter in 
file COIMOD to YES. 

You can preload all the source files to disk before beginning this process, or you can let 
the installation procedures do it for you. If you want to preload your files, refer to 
Using PFLOAD, later in this subsection. 

Each build job calls the procedure PRDIN. At the first reference to the product release 
file, PRDIN looks for a local file of the correct name (for example, NAM5). If the file is 
not local, PRDIN attempts to attach the file from disk. When the file is not on disk, PRDIN I 
issues a RECLAIM command to load the file from the permanent file tapes and then store the 
file on disk. 

The disk files are given the name of the product source file concatenated with the value of 
PSRIN. For example, the disk file for NAM5 would be named NAM5630 (PSRIN defaults to the 
current release level number). Output program libraries are given the name of the product 
concatenated with the value of PSROUT. 

By default, output program libraries are not written and the value of PSRIN is the same as 
the value of PSROUT. That value is the current release level number. Because of this 
naming convention, if you want to write output program libraries, you must change the value 
of PSROUT so that it is different from the value of PSRIN. 

The parameters PSRIN and PSROUT are common parameters. Refer to COMMOD File Parameters 
earlier in this appendix. 



USING PFLOAD 

The quickest way to preload your files is to use PFLOAD. The permanent file tapes were 
written by the RECLAIM utility which produces a tape format dompatible with PFDUMP and 
PFLOAD. However, when you are using PFLOAD to preload your files, note the following: 

• You must specify the DI parameter to force PFLOAD to load files to the proper user 
index. 

• You must specify the FM and DD parameters if you are loading a family device. 

• You must specify the FN parameter if you are loading an auxiliary device. 

• If you are loading multiple disk packs, you might want to use the OP=L option to 
cause PFLOAD to perform load leveling. 

All source program libraries are loaded with names of this format: 
xxxxpsrin 

xxxx The 4-character product name; for example, TEXT and NAM5. 

psrin The value of the PSRIN parameter which, by default, is the current release 
level number. 

Thus, the source program library for NAM5 would be loaded with the name NAM5630. The name 
for the composite OPL is OPLpsrin. Thus, for this release, the name would be OPL630. 
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All other files are given names using this format: 

PFGxxxx 

xxxx The 4-character product name. 

The PFG files are used by SYSGEN. Refer to SYSGEN command, later in this appendix, if you 
want to have SYSGEN use these disk files or if you want to purge the files and have SYSGEN 
use the files from tape. 



DISK INSTALLATION WITH AUXILIARY PACKS 

This type of installation uses the same steps as normal disk installation. However, you 
must change the parameter defaults on the common decks that contain the pack name and type 
definitions. The released defaults are zero. Each product source file is assigned to one 
of the common decks named COMMA, C0MD1B, C0MD2A, C0MD2B, or C0MD3A. The parameters in 
these decks define the pack name and type for the disk pack location of the input and output 
source files. Normal and auxiliary program library assignments are listed in table B-l. 

Each of the common decks contain four parameters. Use the first two parameters to define 
the disk pack name and type for storage of the input source file. Use the other two 
parameters to define the assignment for the output source file which you can assign to a 
different disk pack. 

Each product source file that also serves as an auxiliary program library requires a second 
common deck defining its disk pack location. The second common deck is used in build jobs 
that use the auxiliary program library. This second deck describes the auxiliary program 
library disk location. It is named using the following format: 

COMabcc 

COM Identifies a common deck on DECKOPL. 

a A unique digit or letter that associates this common deck with its product. 

b Is always given the value of X to identify its auxiliary program library 
use, except for COMSOPL. 

cc Two characters, identical to the last two characters of the common deck used 
by PRDIN to locate the input product file. 



Example: 



The RHC product file has its disk assignment in C0MD1A. Product RHF uses RHC as an 
auxiliary program library and, thus, includes the deck C0M6X1A. The pack assignment could 
be as follows: 



C0MD1A 



C0M6X1A 



PN=PACKY 

PR=DJ 

PNO=PACKX PN6-PACKX 

PRO=DJ PR6=DJ 
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Table B-l. Source File and Auxiliary PL Assignments 



Common 
Deck 



C0MD1A 
COMD1A 
COMD1A 
C0MD1A 
COMD1A 
COMD1A 
COMD1B 
COMD1A 
COMD1A 
COMD1A 
C0MD1A 

C0MD1A 
C0MD1A 
C0MD1A 
COMD1A 
COMD1A 
C0MD1A 
COMD1B 
COMD1B 
C0MD1B 
COMD1B 
COMD1B 
COMD1B 
COMD1B 
COMD1B 

C0MD1B 
COMD1B 
C0MD1B 
COMD1B 
C0MD1B 
COMD1B 
COMD1B 
COMD1B 
COMD1B 
COMD1B 
COMD1B 
COMD1B 
COMD1A 
COMD1A 
COMD1A 
COMD1A 



Source 

File 



DDL3 
FTI4 
FTN5 
SRT4 
FCL5 
SRT5 
PMD5 
CDCS 
ITF1 
PASC 
IMF1 

RHF1 
RHP1 
RHC1 
MSSI 
MMCL 
AP1I 
TDU1 
TXIO 
BAS3 
ZHCD 
BIT8 
TEXT 
FDBF 
FTN4 

PLI1 
FCL4 
CCG1 
BINE 
FORM 
UPD1 
F451 
FCL4 
QU31 
CPS1 
CCL1 
BAM1 
TLIB 
TLIB 
NOSB 
NOSB 



Auxiliary 
Common Deckt 



COM4X1A 



COM6X1A 



COM2X1B 



C0M5X1B 



COM1X1B 



Product 
Job 



DDL3 

FTNTS 

FTN5 

SORT 

FCL5 

SORT5 

PMD 
CDCS2 

ITF 

PASCAL 

IMF1 

RHF 

RHP 

RHC 
MSSI 
MMCL 
AP1I 

TDU 
TEXTIO 
BASIC3 

HCD 
BIT8 
TEXT 
FDBF 
FTN4 

PLI 
FCL1 
CCG 
BINEDIT 

FORM 

UPDATE 

F45 

FCL2 

QU3 

COMPASS 

CCL 

BAM 

OSTEXT 

OSLIB 

SOS2B 

RDFEX 



Required 
AUXPLstt 



Common 
Deck 



1 

1 
1,5 

1 



S,l,3,4 
6,S 

S 
1,4 

S,6 
S,6 



S,l 



1,4 

1 

1,5 

1 



1 
1 

S.4 

1,S 
2 
S 
S 
S 
S 



COMD1B 
COMD1B 

COMD2A 
COMD2A 
COMD2A 
COMD2A 
COMD2B 
COMD2A 
COMD2A 

COMD2A 
COMD2B 
COMD2B 



Source 
File 



COMD2B 


CEDG 


COMD2B 


NAM5 


COMD2B 


COB5 


COMD2B 


FCS3 


COMD2B 


APL2 


COMD2B 


LCS3 



LDR1 

AAM2 

CID1 
SYMP 

DCL2 
AGL5 

RBF5 
NSS1 

FMAT 

MDD1 
MCS1 
ZMTS 



Auxiliary 
Common Deckf 



COM3X1B 



Product 
Job 



COM7X2B 



LOADER 
AAM2 
TOOLS 
CID 
SYMPL 
DCL 
ALGOL5 
RBF5 
NSS 
FORMAT 

MDD 
MCS 
MTS 



CEDIAG 

NAM5 
COBOL5 
FCS3 
APL2 
LCS3 
HSIO 

FSE 

MMF 

MSS 

TAF 

IAF 

NOS 

TRACER 

XEDIT 

MAS 
NIP5870 



Required 
AUXPLstt 



S,7 
S 
S 

S 
S,7 
C,S 



s 
s 
s 

s 
s 

s 
s 

s 
s 

s 
s 



tA common deck name in this column identifies the source file as one also used as an auxiliary PL. 
ttEach letter or digit in this column refers to common decks for auxiliary PLs needed by this build job. 
For example, S means COMSOPL, 1 means COM1X1B, 2 means COM2X1B, and C means COMCW (controlware). 
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GENDST PROCEDURE 

Use the GENDST procedure to merge the binaries on file PRODUCT with a base deadstart file 
and generate a new deadstart file. The GENDST procedure ensures that there are no conflicts 
between IAF and RDF on the new deadstart file. 

Here is the format of the GENDST call: 

BEGIN, GENDST, INSTALL, SYSTEM=odt,NEW=ndt,D=density,LIST=list. 

Parameter Description 

SYSTEM=odt Local file name for the old deadstart file. If file odt is 

preassigned, it becomes the base deadstart file; otherwise, a tape 
label request is issued with a VSN=ODT. The default file name is 
SYSTEM. 



NEW=ndt 



Local file name for the new deadstart file. If file ndt is 
preassigned, the new deadstart file is written on it; otherwise, a 
tape label request is issued with a VSN=NDT. The default file name 
is NEW. 



D=density Tape density option. If this parameter is omitted, the value in 

deck COMDEN set in COMMOD is used. The default is PE. The option 
applies to both odt and ndt. Here are the values you can specify 
for tape density: 



density 



Significance 



HI 


556 cpi (7-track) 


HY 


800 cpi (7-track) 


HD 


800 cpi (9-track) 


PE 


1600 cpi (9-track) 


GE 


6250 cpi (9-track) 



LIST=list Local file name for the listing file. The default file name is 
OUTPUT. If you run GENDST interactively and want to save the 
listing file or do not want it to appear at the terminal, specify a 
different file name. 

Run a job similar to the following to add site-provided binaries and deadstart decks to the 
new deadstart file. Create file USERD so it contains the LIBEDIT directives (refer to N0S 2 
Reference Set, Volume 3) to make these additions. 



Job 

job command. 

USER , username , password , f amilyname . 

GET, USERD. 

GET,lfn=pfn. 



Comments 



USERD contains the LIBEDIT directives. 

lfn (permanent file name is pfn) contains the 
modified deadstart decks, lfn must appear in the 
USERD file as *FILE lfn. 



BEGIN , GENDST , INSTALL . 



Parameters are not required if you use the system 
defaults. 
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MISCGET PROCEDURE 

All code that may correct a specific user site problem but which has not been fully tested 
is contained on the file MISCPL. This file was created during the setup of installation 
files. The modifications are properly formatted (Update or Modify) for the intended program 
library. ° 

To list the modification set headers and the decks containing calls to common decks 
containing modification sets, use the following commands: 

BEGIN.MISCGET .INSTALL, HISTORY. 
ROUTE, USER, DC=PR. 

You can extract code from MISCPL using any of the following methods . 

• To extract all modification sets for a product, use the following command: 

BEGIN .MISCGET , INSTALL , PRD=name . 

Replace name with the name for the deck containing a call for each modification set 
available for the product. 

• To extract one modification set, use the following command: 

BEGIN , MI SCGET , INSTALL ,MOD=mod set . 
Replace modset with the name of the required modification set. 

• To extract selected modification sets, use the following commands: 

NOTE ,lfn,NR.+,modname+,modname+, .modname. 

BEGIN, MISCGET, INSTALL,MISCIN=lfn. 

These calls to MISCGET append the modification sets to the local file USER. You should then 
save file USER as a permanent file for later use by the corresponding build procedure. 
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REPORT PROCEDURE 

To obtain statistics on all completed installation jobs, run a job that contains this 
command. (The job output indicates the resources used for each installation job and whether 
the job passed or failed.) 

BEGIN , REPORT , IN STALL , XC . 



| NOTE 



The REPORT procedure uses the direct access 

file REP. If the binary file cannot be 

found or if the XC keyword is present, REP 
is recompiled. 



RESETP PROCEDURE 

You can use the RESETP procedure to reduce the size of files PRODUCT and DIRFILE. This 
procedure makes more disk space available and speeds up the subsequent LIBEDITs of more 
binaries into file PRODUCT. 

Initially, procedure SEED creates the file PRODUCT with user libraries that are used by the 
build procedures, and creates DIRFILE with entries for those ULIBs. The build procedures 
subsequently add binaries to the file PRODUCT and directives to file DIRFILE. Only those 
user libraries used by subsequent build jobs are required to remain on file PRODUCT after 
GENDST creates a new deadstart tape. 

To use the RESETP procedure to reduce the size of files PRODUCT and DIRFILE, follow these 
steps: 

1. Run GENDST to create a new deadstart tape. 

2. After writing the new deadstart tape, enter this command: 

BEGIN , RESETP , INSTALL . 
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SETUP PROCEDURE 

The SETUP procedure generates the permanent file INSTALL, which contains all installation 
procedures. The SYSGEN(FULL) function (as well as other SYSGEN functions) initially loads 
files from the permanent file tapes and creates INSTALL. SETUP can also perform the 
following functions: 

Create INSTALL from DECKOPL with optional modifications against DECKOPL. 

Rename file INSTALL to a specified name. 

Create a 63-character set version of procedures on INSTALL. 

Convert DECKOPL and INSTALL to a 63-character set format. 

Replace DECKOPL with an updated DECKOPL. 

Here is the format for calling SETUP: 

BEGIN , SETUP , INSTALL , params . 

Parameter Description 

NEWPL Replaces DECKOPL with modified DECKOPL. If NEWPL is omitted, 

DECKOPL is not replaced. 

MOD=filename Applies modsets from specified file to DECKOPL; the file can be a 
local file or a direct access permanent file. If you change any 
default parameters in COMMOD and you also have your own local 
changes to DECKOPL, append your changes to file COMMOD. Then use 
MOD=C0MM0D in your procedure call. 



DF63 



Selects 63-character-set version of installation procedures for 
inclusion on file INSTALL. 



CV63 Converts DECKOPL to 63-character-set format. 

INSTALL=filename Creates or replaces procedure file specified. The default is 

INSTALL. If you omit the INSTALL keyword, procedure file INSTALL 
is not created or replaced. 

Example: 

The following sample call to the SETUP procedure applies modifications from file COMMOD 
against the DECKOPL installation procedures and creates a new INSTALL procedure file. 
DECKOPL is not updated. 

BEGIN , SETUP , INSTALL ,MOD=COMMOD , INSTALL . 
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SYSGEN COMMAND 

SYSGEN consists of several procedures for loading all the permanent files for NOS and its 
product set from the released permanent file tapes. SYSGEN also contains procedures to 
perform the following: 

Create a new deadstart tape; refer to SYSGEN(DST). 

Merge binaries received with a component order with an existing deadstart tape; 
refer to SYSGEN (UPGRADE). 

Load files needed to perform a customized installation; refer to SYSGEN (SOURCE). 

Copy the running system to tape or disk; refer to SYSGEN (COPYSYS). 

Move files from the installation user name INSTALL to a system user name; refer to 
SYSGEN (MOVE). 

Make a copy of the release materials; refer to SYSGEN (COPYTAP). 

Build a new deadstart tape with the trace/debug versions of NAM, RBF, and/or PSU; 
refer to SYSGEN (SWAP). 

Add a 63-character set version of PSU to your system. 



SYSGEN VALIDATIONS 

To use SYSGEN, your validation file must contain the correct user names and passwords. If 
you do not have a validation file, the SYSGEN(FULL) function automatically creates one with 
the necessary validations. If you have a validation file, modify the file via MODVAL so 
that it contains the user names and passwords that SYSGEN needs. If you need to modify 
SYSGEN, refer to SYSGEN maintenance in this section. Then, after completing your 
installation, restore the file for security. Table B-2 shows a list of the user names and 
passwords for SYSGEN. 
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Table B-2. SYSGEN User Names and Passwords 



User Name 



LIBRARY 
SYSTEMX 
NETOPS 

MANUALS 
INSTALL 

APLO 

APL1 

SSPOT 

CDCCE 

CDCCE2 

KB100DC 

SUBFAMO 



Password 



LIBRARY 
SYSTEMX 
NETOPSX 

MANUALS 
INSTALL 

APLO 

APL1 

STATION 

CDCCE 

CDCCE 2 

TAFPASS 

SUBFAMO 



Files Installed 



FSE, XEDIT, and CCL (command help) files. 

NAM and other subsystem startup procedure files. 

NAM and related subsystem procedure startup files and CCP load 
files. 

Online manual files. 

RECLAIM database file, DECKOPL, and other files needed for 
installation jobs. 

For APL2 product only. 

For APL2 product only. 

For NOS Scope Station Facility only; no files installed. 

Customer engineer files for MSSI and MAP III or MAP IV-23/25. 

Customer engineer files for MSSI and MAP IV-20/21. 

For the TAF task library, TASKLIB. 

For the Mass Storage Extended configuration file, MSASCON. 



SYSGEN MAINTENANCE 

The SYSGEN procedures are maintained in deck SYSGEN on DECKOPL. To create a new set of 
SYSGEN procedures, execute this command: 

BEGIN , SYSGEN , INSTALL . 

The SYSGEN procedures consist of a PROC/SYSGEN and a ULIB/PFGLIB on the deadstart file. The 
BEGIN(SYSGEN, INSTALL) command adds SYSGEN to the PRODUCT and GLOBLIB files. (If GLOBLIB and 
PRODUCT are attached and a LIBRARY(GLOBLIB) has been done, all SYSGEN functions execute from 
PRODUCT and GLOBLIB from the global library.) 

If you need to modify SYSGEN (for example, to set correct user names), you should append 
your modifications to file COMMOD. Then, run the SETUP procedure, using MOD=COMMOD, to 
create a new INSTALL procedure file. 

All user names used by SYSGEN are stored in the USER procedure within deck SYSGEN. 
SYSGEN(MODVAL) is the routine that creates the user names. 
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SYSGEN FUNCTIONS 

The SYSGEN functions set up all the permanent files for NOS and its product set. You can 
execute all SYSGEN functions from DIS, from an interactive terminal, or from a batch job. 

If you are executing the SYSGEN functions from the system console, use the X. SYSGEN format 
call from DSD. You can also execute the SYSGEN functions by using these sequences of 
commands: 

X.DIS. 

SUl(userindex) 

SYSGEN( function , par ams) 



X.DIS. 

USER(username, password) 

SYSGEN ( function , par ams ) 

These sequences will install the files to the specified user name/user index. If you are 
executing SYSGEN from an interactive terminal, the files will be installed to the login user 
name. For example, you can execute the SYSGEN(FSEH) function from your terminal and install 
the FSE help files to your own permanent file catalog rather than the LIBRARY catalog. 
Thus, you can examine the files before you install them for the entire system. 

Replace function with the name of the function you want to execute. The following pages 
detail all the SYSGEN functions in alphabetical order. 

Replace params with the possible parameters for a specific function. 

Some of the SYSGEN functions should be executed from DSD. To execute a function from DSD, 
type X. before the command. For example, 

X.SYSGEN(FULL) 

| The SYSGEN functions that are run from DSD are documented with the X. before the command. 



SYSGEN(COPYSYS) 

This function copies a running system file to disk or tape. Use this format to call the 
function: 

| X.SYSGEN(COPYSYS, est, type) 

Replace est with the EST ordinal of the device you want to copy to. 

Replace type with either the word DISK for copying a running system to disk, or a value 
for a tape density: HY, HD, PE, or GE. If you are copying to disk, the procedure 
executes the INSTALL command to create a disk deadstart file. If you are copying to 
tape, the procedure executes the ASSIGN command. Thus, you should mount the tape you 
are copying to before executing this function. 
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SYSGEN(COPYTAP) 

This function makes copies of the release materials: the deadstart tape, permanent file 
tapes, and 700 CIP tape. To use this function, you need two tape drives. Here is the 
format to call the function: 



X.SYSGEN(COPYTAP,aaaaa,dl,numpf,dst,cip) 
Parameter 



Description 



dl 
numpf 

dst 
cip 



Specifies the first 5 characters of the VSN of the permanent 
file tape. 

Specifies the density of the release tapes. 

Specifies the number of permanent file tapes to copy. Specify 
if you do not want to copy any of the tapes. 

Specifies whether to copy the deadstart tape. Enter YES or NO. 
Specifies whether to copy the CIP tape. Enter YES or NO. 



If you specify that permanent file tapes should be copied, the function blank-labels 
numpf tapes. Be sure to use the same size tapes as the release tapes. The function 
then requests the first original tape and the first new tape and begins copying. Mount 
the tapes when you are requested to do so. 

After the permanent file tapes are copied, the function copies the deadstart tape and 
then the CIP tape. v 



SYSGEN(DST) 

This function creates a new deadstart tape. Use this function when you have made simple 
changes to your deadstart file. For example, you have added or replaced deadstart 
decks. If you want to create a new tape using the PRODUCT file, use the GENDST command 
(refer to GENDST in this appendix). Here is the format for the SYSGEN(DST) function: 



SYSGEN(DST, old, lgo.new, input, dd) 



Parameter 



old 



lgo 



new 



Description 



Name of the base deadstart file. This deadstart file should be 
local to your job or you should supply the dd parameter so that 
SYSGEN can request a deadstart tape to use as the base. If a 
tape is requested, the VSN is ODS. This file can be a pre- 
assigned magnetic tape file. 

Name of the file which contains the binaries to update file 
old. If lgo is not local, SYSGEN looks for a permanent file 
with that name. You can specify (zero) if no binaries are to 
be updated. 

Name of file to receive the new deadstart file. This file can 
be a preassigned magnetic tape. 



I 
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Parameter Description 



input Name of a file containing directives for the LIBEDIT that SYSGEN 
performs. Specify (zero) if you have no LIBEDIT directives. 

dd Tape density for any tapes to request. If you don't specify a 

tape density, no tape requests are made and SYSGEN only deals 
with local files. 



SYSGEN(FILES) 

Use this function to load all the permanent files from the permanent file tapes that are 
released with a component order. This function loads all the files from the permanent 
file tapes except for the RECLAIM database. Also, this function does not create a 
validation file. Use SYSGEN(FILES) after using the SYSGEN(UPGRADE) function when you 
are installing a component order. 

Here is the format for calling SYSGEN(FILES) : 

| X.SYSGEN(FILES,vsn) 

Replace vsn with the VSN listed on the external tape label. 

SYSGEN(FULL) 

The SYSGEN(FULL) function loads all the permanent files for a standard installation. 
First, SYSGEN(FULL) loads your RECLAIM database and sets up a validation file (if you 
have none). Next, SYSGEN(FULL) loads the permanent files. The types of files loaded 
include all subsystem startup procedure files, help files, online manuals, and other 
permanent files associated with specific products. If you are performing a customized 
installation, refer to SYSGEN( SOURCE) in this subsection. Here is the format for 
calling SYSGEN(FULL): 

X. SYSGEN (FULL) 

SYSGEN (MOVE) 

The SYSGEN(MOVE) function moves permanent files produced by installation jobs to other 
user names. (The user names must be known to SYSGEN. Refer to SYSGEN Maintenance 
earlier in this subsection.) You must execute SYSGEN(MOVE) from the system console. 
Here is the format for calling SYSGEN(MOVE): 

X.SYSGEN(MOVE,pfn,un,ct,m,ac) 
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Parameter Description 

P ri > Name of the permanent file to be moved. The file must reside on 

installation user name INSTALL. 

un User name to receive files. Valid user names are INSTALL, 

SYSTEMX, LIBRARY, KB100DC, CDCCE, CDCCE2, MANUALS, SSPOT, 
NETOPS, APLO, APL1, and SUBFAMO. SYSGEN supplies the password. 
For the list of passwords, refer to SYSGEN Validations earlier 
in this subsection. 

ct Specifies the permanent file category. Allowable values are PU 

for public, PR for private, and S for semiprivate. The default 
is PR. 

m Specifies permission mode. Allowable values are R for read only 

and W for write. The default is R. 

ac Specifies the alternative catalog CATLIST option. You can enter 

Y to allow alternative catalogs to CATLIST the file, or you can 
enter N to prevent alternative catalogs from using CATLIST to 
list the file. 



SYSGEN (RECLAIM) 

This function loads files from the permanent file tape(s) and leaves them as local 
files. This function should not be called from DSD but can be called from DIS or an 
interactive terminal. Here is the format for the call: 

SYSGEN(RECLAIM,fl,f2,f3,f4,f5) 

Replace f 1 through f5 with the names of the files you want to load from the dump 
tape(s). (You can load up to five files with each call.) 



| NOTE 



To use SYSGEN (RECLAIM), you must have 
previously loaded the RECLAIM database for 
the dump tapes to user name INSTALL. (This 
is done automatically by the SYSGEN(FULL) or 
SYSGEN (SOURCE) function.) 



SYSGEN (SOURCE) 



This function loads files from the permanent file database and enables you to begin a 
customized installation. This function can be run from DSD, DIS, or from an interactive 
terminal. Refer to section 3 for more information. Here is the format for calling the 
function: 

X. SYSGEN (SOURCE , CCP ) 
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Include the keyword CGP If you want to begin a customized installation of CROSS/CCP at 
the CCPVAR step. (Refer to section 5.) 

SYSGEN(SODRCE) sets up the RECLAIM database and the files DECKOPL, COMMOD, CODEPL, 
MISCPL, NAMSTRT, OSERBPS, INSTALL, and DBUBIN. These are set up on the same user name 
as the SYSGEN (SOURCE) is executing from. SYSGEN (SOURCE) also puts a copy of RECLAIM on 
an indirect access permanent file. 

Once SYSGEN (SOURCE) has completed, you can use RECLAIM to examine various release 
materials. 



SYSGEN (SWAP) 



This function creates a new deadstart tape with the DEBUG/TRACE versions of NAM, RBF, 
and PSU. Here is the format for calling this function: 



X. SYSGEN (SWAP, density ,pl,p2,p3, type) 
Parameter 



Description 



density Specifies the density of the new deadstart tape. 

pl,p2,p3 Specify the products to be swapped. You can specify RBF, NAM, 
and PSU. Any combination can be used. 

type Specify the type of PSU to swap in. You can specify T64 for 

trace 64-character set; NT63 for nontrace 63-character set; or 
T63 for trace 63-character set. The default is T64. (This 
parameter is ignored for RBF and NAM. ) 



NOTE | 



Be sure to keep a copy of your original tape 
that contains the non-DEBUG /TRACE binaries 
of the products. 



SYSGEN (UPGRADE) 

The SYSGEN (UPGRADE) function merges the binaries you receive for a component order with 
your existing system. You can use SYSGEN (UPGRADE) to perform any of these functions: 

• Merge the component-order binaries with a tape copy of your system and then create a 
new deadstart tape. 

• Merge the component-order binaries with a local file copy of your system and then 
create a new deadstart local file. (You can then write the file to tape or create a 
disk deadstart file.) 

• Update the RECLAIM database without merging the binaries. 

To merge binaries with a tape copy of your system and create a new deadstart tape, use 
this format: 



X. SYSGEN (UPGRADE , OLD , NEW , vsn , dl , d2 ) 
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To merge binaries with a local file copy of your system and create a new local deadstart 
file, use this format: 

SYSGEN(UPGRADE,old,new,vsn,dl) 
To update the RECLAIM database without merging the binaries, use this format: 
X.SYSGEN(UPGRADE,0,0,vsn,dl) 



Parameter 



old 



vsn 



dl 
d2 



Description 

Name of local file containing the binaries of the current system. 

Name of local file to receive the merged binaries. 

Volume serial number of the CDC-supplied permanent file dump 
tape. The VSN is listed in the media number field on the 
external tape label. 

Tape density of the permanent file dump tape. 

Tape density of both the old and new deadstart tapes. The old 
deadstart tape is requested with the VSN of ODT; the new 
deadstart tape is requested with the VSN of NDT. 
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FILE FORMATS 



ORDER OF PRODUCTS 

The order in which products appear on the deads tart tape is now controlled by DECKOPL in 
each build deck. The basic order is alphabetical. 



NOTE 



All ULIBs are in library 4. 



Arrangement of deadstart tape libraries: 



Library 


Description 
Fixed order (CTI) 


Contributing Build Decks 


1 




2 


Fixed order 




NOS, HSI0, MMF, DISK C0NTR0LWARE 


3 


NOS 




NOS, N0S2B, NIP5870 


4 


All ULIBs 




Many 


5 


Miscellaneous 


items 


TDU, PFTF, Misc. firmware 


6 


AAM2 




AAM2 


7 


AGL5 




ALGOL5 


8 


APL2 




APL2 


9 


BAM1 




BAM 


10 


BAS3 




BASIC 3 


11 


BINE 




BINEDIT 


12 


BIT8 




BIT8 


13 


CCL1 




CCL 


14 


CDCS 




CDCS2 


15 


CEDG 




CEDIAG 


16 


CID1 




CID 


17 


CML1 




CML 


18 


COB 5 




C0B0L5/C0B0L5Q 


19 


CPS1 




COMPASS 


20 


DDL3 




DDL3 


21 


(empty) 






22 


FDBF 




FDBF 


23 


FORM 




FORM 


24 


FMAT 




FORMAT 


25 


FSE1 




FSE 


26 


FTN4 




FTN4/FTNTS,FCL1 ,FCL2 


27 


FTN5 




FTN5.FCL5 


28 


F451 




F45 


29 


IAF1/RDF1 




IAF/RDFEX 


30 


IMF1 




IMF1 


31 


ITF1 




ITF 


32 


LDR1 




LOADER 


33 


MMCL/MSSI 




MMCL/MSSI/AP1I 


34 


MAS 




MAS 


35 


MCS1 




MCS 


36 


MDD1 




MDD 
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Library 


Description 


37 


MMF1 


38 


MSS1 


39 


NAM5 


40 


(empty) 


41 


NSS1 


42 


OSTX 


43 


PASC 


44 


PLI1 


45 


PMD5 


46 


PSU1 


47 


QU31 


48 


RBF5 


49 


RHF1 


50 


(empty) 


51 


RHP1 


52 


SRT4 


53 


SRT5 


54 


SYMP 


55 


TAF1 


56 


TEXT 


57 


TXIO 


58 


TOOL 


59 


TRCE 


60 


UPD1 


61 


XEDT 


62 


(empty) 


63 


(empty) 



Contributing Build Decks 

MMF 
MSS 
NAM5/NAM5D 

NSS 

OSTEXT 

PASCAL 

PLI 

PMD 

PSU 

QU3 

RBF5/RBF5D 

RHF 

RHP 

SORT 

SORT5 

SYMPL 

TAF 

TEXT 

TEXTIO 

TOOLS 
TRACER 
UPDATE 
XEDIT 



The following is a list of all files on the permanent file tape(s). All source files are 
listed first, followed by all PFG files (files processed by SYSGEN). At the end of the list 
are files which are received only on a component order. 



| NOTES 



Your tape contains only the files for the 
products you have ordered. 



To see a list of all the files on your permanent file tape(s), follow these steps: 

1. Load the RECLAIM database using either the SYSGEN(FULL) or SYSGEN(SOURCE) command. 

2. Enter this command from your installation user name: 

RECLAIM , Z . /LIST ,UN=NS2psrin. 

Replace psrin with the release level, for example, 630. 

This will generate a report that lists the names of all the files on the tape(s) in 
alphabetical order. Because the report is generated from information in the RECLAIM 
database, the permanent file tape(s) will not be requested. 
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SOURCE FILES 

All source files end with the value psrln, the current NOS release level. For example, the 
AAM2 source file appears as AAM2630 at NOS level 630. The table does not list the psrin I 
value . i- ■ 

Unless otherwise noted, all source files contain one random formatted UPDATE program library. 
Source Files: 



AAM2 
AGL5 

APL2 



Associated 

DECKOPL 

Procedure Name 

AAM2 
ALGOL 5 
APL2 



File 1. 
File 2. 
File 3. 
File 4. 
File 5. 
File 6. 
File 7. 
File 8. 
File 9. 
File 10. 
File 11. 
File 12. 
File 13. 



Format Notes 



Program library. 
APLLIB. Relocatable of APL. 
APLPROD. Absolute of APL. 
TAPLTST. APL verification jobs. 
TAPLOUT. Sample output for file 4. 
NEWSF. APLNEWS, news file. 
FILESYS. Workspace, file functions. 
FILES2. Workspace, file functions. 
APLNEWS. Workspace, information. 
CATALOG. Workspace, information. 
WSFNS. Workspace, general functions. 
TAPLWS. Workspace for APL verification. 
Reserved. 



API I 



API! 



API Online Diagnostics for MAP III and MAP IV. 

File 1. FTN5 version of source PL. 

File 2. FTN4 version of source PL. 

File 3. CSTFU 

File 4. CSCMD 

File 5. CSQMM 

File 6. CSMAINT 

File 7. CSVDMT 

File 8. CS24KM 

File 9. CSDSOP4 

File 10. CSECS 

File 11. CSECSTA 

File 12. CSHSMT for 24K Memory Size 

File 13. CSHSMT for 48K Memory Size 

File 14. CSHSMT for 64K Memory Size 

File 15. CSCMI for 6 4K Memory Size 

File 16. CSCMI for 48K Memory Size 

File 17. CSCMI for 24K Memory Size 



BAM1 
BAS3 
BINE 
BIT 8 
CCG1 
CCL1 



BAM 

BASIC 3 

BINEDIT 

BIT8 

CCG 

CCL 
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Associated 
File DECKOPL 
Name Procedure Name 



Format Notes 



CCPB 



CCPPH1, CCPBLB 



File 
File 
File 
File 
File 
File 
File 



File 8. 

File 9. 

File 10. 

File 11. 

File 12. 

File 13. 



Program library for CCP base. 

Expand and autolink binaries. 

Mux firmware (phase 1) load module. 

Dump bootstrap module. 

System autostart (SAM) load module. 

Symbol table for dump bootstrap load module. 

Combined binary library (BCMB) for generation 

of phase 2 variant load modules. 

Compiler listing for-'expand and autolink. 

CCP listing for phase 1 load module. 

CCP listing for dump bootstrap load module. 

CCP listing for system autostart load module. 

CCP assembly listing for BCMB. 

CCP Pascal listing for BCMB. 



CCPD 
CCPR 
CCPT 
CDCS 
CEDG 
CID1 
COB 5 

CPS1 
CRSS 



CCPPH1 

CCPPH1 

CCPPH1 

CDCS 2 

CEDIAG 

CID 

C0BOL5 

COMPASS 
CROSS 



CCP online diagnostics - sequential PL. 

CCP Remote Concentrator (LIP) - sequential PL. 

CCP 3270 Bisync TIP - sequential PL. 



File 1. Sequential PL. 

Files 2,3,4. Used by the C0B0L5Q build procedure. 



File 

File 

File 

File 

File 

File 

File 

File 8. 

File 9. 

File 10. 

File 11. 



Source program library. 

Absolute binary for Cross. 

Empty. 

Empty. 

Pascal cross-reference. 

MPLINK. 

MPEDIT. 

CCP Pascal compiler. 

Pascal compiler bootstrap. 

Empty. 

Cross program listing. 



DCL2 



DCL 



File 1. 
File 2. 
File 
File 
File 
File 
File 
File 8. 
File 9. 
File 10. 
File 11. 



Program library. 
SEGLOAD directives. 
Absolute for DCUPD. 
Absolute for DCSEL. 
Absolute for DCRPT. 
Absolute for DCRET. 
Absolute for DCCONVT. 
Absolute for DCUTL. 
Absolute for DCIDX. 
Absolute for DCGEN. 
Absolute for DCCONGN. 



DDL3 
FCL4 
FCL5 



DDL3 

FCL1/FCL2 

FCL5 
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Associated 
File DECKOPL 
Name Procedure Name 

FCS3 FCS3 



FDBF 


FDBF 


FMAT 


FORMAT 


FORM 


FORM 


FTI4 


FTNTS 


FTN4 


FTN4 


FTN5 


FTN5 


F451 


F45 


IMF1 


IMF1 


ITF1 


ITF 



Format Notes 

File 1. Program library. 

File 2. Binary data for FORTRAN file conversion 

processor (FCP) verification. 
File 3. Binary data for COBOL FCP verification. 
File 4. Absolute load module CBLFCP1 for COBOL FCP. 
File 5. Absolute load module CBLFCP2 for COBOL FCP. 
File 6. Absolute load module FTNFCP1 for FORTRAN FCP. 
File 7. Absolute load module FTNFCP2 for FORTRAN FCP. 
File 8. FORTRAN binary syntax file CBLFCPM for COBOL 

FCP. 
File 9. FORTRAN binary syntax file FTNFCPM for 

FORTRAN FCP. 



LCS3 



LCS3 



LDR1 
MCS1 
MDD1 
MMCL 
MSSI 
NAM5 
NSS1 
OPL 



LOADER 

MCS 

MDD 

MMCL/AP1L 

MSSI 

NAM5 

NSS 



File 1. 
File 2. 
File 3. 
File 4. 

File 5. 

File 6. 

File 7. 



Program library. 

Absolute load module for LCS. 

FORTRAN binary syntax for LCS. 

Absolute load module COUP for COSY-to-Update 

file conversion. 

Absolute load module COPYCOB for 

COBOL -COPY-library file conversion. 

Binary data file for COSY-to-Update file 

conversion (file 1 of 2). 

Binary data file for COSY-to-Update file 

conversion (file 2 of 2). 



PASC 


PASCAL 


FLU 


PL I 


PMD5 


PMD 


QU31 


QU3 


RBF5 


RBF5 


RHC1 


RIIC 



This is a composite OPL of all the NOS MODIFY products 
you ordered. It may contain the PLs for NOS, N0S2B, 
FSE, HSIO, IAF, MMF, MSS, TAF, TOOLS, TRACER, MAS, 
RDFEX, and XEDIT. 
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Associated 


File 


DECKOPL 


Name 


Procedure Name 


RHF1 


RHF 


RHPI 


RHP 


SRT4 


SORT 


SRT5 


SORT5 


SYMP 


SYMPL 


TDD1 


TDU 


TEXT 


TEXT 


TLIB 


OSLIB 


TXIO 


TEXTIO 


UPD1 


UPDATE 



Format Notes 



File 1. Modify PL TD7BASE. 

File 2. SESPLIB. 

File 3. TDUCOMM. 

File 1. Contains TDU input file. 



VSMl 



CCPVAR 



CCP VARIANT VSM1 

File 1. CCP variant (phase 2) load module. 
File 2. CCP PICB load module. 
File 3. Symbol table for CCP variant and PICB. 
File 4. CCP listing for CCP variant build (MPLINK). 
File 5. Listing of CCP variant build (MPEDIT). 
File 6. Listing of PICB build (Pascal, MPLINK, and 
MPEDIT). 



W1F 


CCPVAR 


VV1L 


CCPVAR 


W2F 


CCPVAR 


VV2L 


CCPVAR 


W3F 


CCPVAR 


VV3L 


CCPVAR 


VLC1 


CCPVAR 


VLC2 


CCPVAR 


VLC3 


CCPVAR 


VLC4 


CCPVAR 



CCP variant V1F; same format as file VSMl. 
CCP variant V1L; same format as file VSMl. 
CCP variant V2F; same format as file VSMl. 
CCP variant V2L; same format as file VSMl. 
CCP variant V3F; same format as file VSMl. 
CCP variant V3L; same format as file VSMl. 
CCP variant SM; same format as file VSMl. 
CCP variant SM; same format as file VSMl. 
CCP variant SM; same format as file VSMl. 
CCP variant SM; same format as file VSMl. 



ZHCD 



HCD 



819 PP Driver. 
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All of the following files are processed by SYSGEN. 
tape(s) and have this naming format: 



They are stored on the permanent file 



PFGxxxx 
where xxxx is a four-character product name (for example, APL2). 

The following table lists each file name, the file's associated DECKOPL procedure name, the 
SYSGEN procedure which installs the file, and the format of the file. When a DECKOPL 
procedure is listed, it is the name of the procedure that generates the associated file. 
Many of the files listed do not have associated DECKOPL procedures. To install the files 
that do not have an associated DECKOPL procedure, you must either use the SYSGEN function 01 
explicitly get the file from the tape by using the RECLAIM command or the SYSGEN(RECLAIM) 
function. 



All files loaded by SYSGEN( SOURCE, CCP) are marked with an asterisk (*). 
loaded by SYSGEN(FULL) or SYSGEN(FILES,vsn). 



All other files are 



File 


DECKOPL 


SYSGEN 




SYSGEN 


Name 


Procedure Name 


Procedure Name 


Function/Notes 


PFGAPL2 


APL2 


APL2 


File 1. 
File 2. 
File 3. 
File 4. 
File 5. 

File 6. 
File 7. 


Empty file. 

APLLIB. Relocatable of APL. 

APLPROD. Absolute of APL. 

TAPLTST. APL verfication job. 

TAPLOUT. Sample output for 

file 4. 

NEWSF. APLNEWS, news file. 

FILESYS. Workspace, file 



PFGAP1I 



AP1I 



AP1I 



functions. 
File 8. Files2. Workspace, file 

functions. 
File 9. APLNEWS. Workspace, information. 
File 10. CATALOG. Workspace, information. 
File 11. WSFNS. Workspace, general 

functions. 
File 12. TAPLWS. Workspace for APL 

verfication. 

API Online Diagnostics for MAP III and 

MAP IV. 

File 1. CSTFU. 

File 2. CSCMD. 

File 3. CSQMM. 

File 4. CSMAINT. 

File 5. CSVDMT. 

File 6. CS24KM. 

File 7. CSDS0P4. 

File 8. CSECS. 

File 9. CSECSTA. 

File 10. CSHSMT (24K memory). 

File 11. CSCMI (24K memory). 
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File 

Name 

FFGAP1L 



IKCKOPL 
Procedure Name 

AP1L 



SYSGEN 
Procedure Name 

AP1L 



*PFGOCPB 



CCPPH1/ 
CCPBLB 



CCPB 



PFGCCPL 


CCPLOAD 


CCPL 


File 1. 


*PFGCCPO 




CCPU 


File 1. 


PFGCDCS 


CDCS2 


CDCS 


File 1. 


*PFGCODE 




CODE 


File 1. 


*PFGCRSS 


CROSS 


CRSS 


Cross B 



PFGCML1 



*PFGCSTD 



*PFGDBU1 



CML1 



CSTD 



DBU1 



SYSGEN 
Function/Notes 

MMCL files for API Online Diagnostics. 
File 1. AP1LIB1; Channel Coupled MAP 

1V-2X. 
File 2. AP1LIB2; Channel Coupled MAP 

IV -2X. 
File 3. AP1LIB3; Channel Coupled MAP 

IV-2X. 
File 4. AP1LIB1; ECS/CMI Coupled MAP 

III/IV. 
File 5. AP1LIB2; ECS/CMI Coupled MAP 

III/IV. 
File 6. AP1LIB3; ECS/CMI Coupled MAP 

III/IV. 

File 1. Expand/ autolink directives PL. 
File 2. Expand and autolink binaries. 
File 3. Mux firmware (phase 1) load 

module. 
File 4. Dump bootstrap module. 
File 5. System autostart (SAM) load 

module. 
File 6. Symbol table for dump bootstrap 

load module. 
File 7. Combined binary library (BCMB) 

for generation of Phase 2 variant 

modules . 
File 8. Updated combined program library 

(PCMB). 



Contains CCP NLFFILE. 
Contains CCP OSERBPS file. 
Contains CDCS startup prodedure. 
Contains CODEPL. 



Cross Binary Install Permanent Files. 

File 1. Empty. 

File 2. Absolute binary for CROSS. 

File 3. Empty. 

File 4. Empty. 

File 5. Pascal cross-reference. 

File 7. MPEDIT. 

File 8. CCP Pascal compiler. 

File 9. PASCAL compiler bootstrap. 

Refer to CML Reference Manual for specific 
file format information. 

File 1. COMPASS coding standards. 
File 2. SYMPL coding standards. 



File 1. For use by 0JJ3. 



C-8 



60459320 E 



File 


DECKOPL 


SYSGEN 


t 


SYSGEN 


Name 


Procedure Name 


Procedure Name 


Function/Notes 


PFGDCL2 


DCL 


DCL2 


Permanent files for Data Catalogue 2 V2.0 








File 1. 


Absolute for DCUPD. 








File 2. 


Absolute for DCSEL. 








File 3. 


Absolute for DCRPT. 








File 4. 


Absolute for DCRET. 








File 5. 


Absolute for DCCONVT. 








File 6. 


Absolute for DCUTL. 








File 7. 


Absolute for DCIDX. 








File 8. 


Absolute for DCGEN. 








File 9. 


Absolute for DCCONGN. 



*PFGDECK 



DECK 



PFGFSEH 



FSEH/ 
FSES 



PFGFSE1 


FSE 


FSE1 


PFGHELP 




HELP 


PFGIAF1 


IAF 


IAF1 



PFGITF1 ITF 



PFGMAN1 



ITF1 



MAN1 



PFGMCS1 


MCS 


MCS1 


*PFGMISC 




MISC 


PFGMMCL 


MMCL 


MMCL 



DECKOPL permanent files. 

File 1. DECKOPL. 

File 2. INSTALL procedure file. 

File 3. COMMOD. 

File 4. GDIR program binaries. 



FSE Help Files. 
File 1. FSEHELP file. 
File 2. FSTEACH file. 
File 3. FSEPROC file. 
File 4. SMFSTAT procedure. 

File 1. Contains SMF startup file. 

File 1. Contains HELPLIB file. 

Interactive Facility Startup procedures. 
File 1, record 1. Startup proc IAF. 
File 1 , record 2. Startup proc IAFTM. 
File 1, record 3. Startup proc IAFTR. 

File 1. Contains ITF NAMSTRT startup 
record. 

Optional set of online manuals: 

procedures, source and bound copies of the 

manuals. 

File 1 . Contains installation procedures 

and documentation for all other 

files in this file. 

File 1. MCS STARTUP PROCEDURE. 

File 1. Contains MISCPL. 

MAP III/IV-2X Macro Control Library Files. 
File 1. MAPLIBE - MAP III, MAP IV-23/25. 
File 2. MAPLIBC - MAP IV-20/21. 
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File 
Name 


DECKOPL 
Procedure Name 


SYSGEN 
Procedure Name 


PFGMAS 


MAS 


MAS 


PFGMSSI 


MSSI 


MSSI 



PFGMSSI 


MSS 


MSSI 


PFGNAMD 


NAM5D 


SWAP 


PFGNAM5t 


NAM5 


NAM5/ 
NAMS 



PFGNDL1 



NDL1 



PFGNSS1 



PFGONLM 



NSS 



NSS1 



ONLM 



PFGPFT1 



PFT1 



*PFGPRPT 



PRPT 



SYSGEN 
Function/Notes 



MSSI 3 Permanent Files. 
File 1. MAPCMI startup procedure. 
File 2. MAPECS startup procedure. 
File 3. MAPCH startup procedure. 
File 4. MSSIP - misc. MSSI/MMCL 

procedures. 
File 5. MJOBSFL - MSSI test jobs PL. 

File 1. MSS startup procedure. 

NAMS trace/Debug binaries. SYSGEN 
procedure SWAP is used to load these 
binaries. 



NAM startup files. 

File 1. NAMSTRT file. 

File 2. NAM startup procedure. 

File 3. NAMNOGO startup procedure. 

Network Definition File. 

File 1, record 1. NDL source file NDLDATA. 

File 1, record 2. If present, files 2 and 

3 will also be present. 

File 2. Compiled NCFFILE of NDLDATA. 

File 3. Compiled LCFFILE of NDLDATA. 

File 1. NOS Scope Station startup 
procedure. 

Default set of online manuals: procedures, 
source and bound copies of the manuals. 
File 1. Contains installation procedures 

and documentation for all other 

files in this file. 

Protocol File Transfer Facility. 

File 1. PROC/KMUGET (64-character set 

version) 
File 2. PROC/RMUGET (63-character set 

version) 
File 3. ULIB/PFTF (debug version) 

Contains history idents of NOS PSR code in 
current release. 



fFor SYSGEN (FULL), NAMSTRT is loaded to user name NETOPS, NAM and NAMNOGO to SYSTEMX. 
For SYSGEN (SOURCE), NAMSTRT is loaded to user name INSTALL. 
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File 
Name 

PFGPSUD 



DECKOPL 
Procedure Name 



PFGPSU1 

PFGSRB1 
PFGRBFD 

PFGRBF5 



PFGTLIB 



PFGXEDT 



SYSGEN 
Procedure Name 

SWAP 



RBF5D 



RBF5 



PSU1 

SRBl 
SWAP 

RBF5 



PFGPvDFl 


RDFEX 


RDF1 


PFGRHP1 


RHP 


RHP1 


PFGTAF1 


TAF 


TAF1 



XEDIT 



TLIB 



XEDT 



SYSGEN 
Function/Notes 

Printer Support Utility binaries. SYSGEN 
procedure SWAP Is used to load these 
binaries . 

File 1. 64-character set trace binaries. 
File 2. 63-character set trace binaries. 
File 3. 63-character set nontrace 
binaries. 

File 1. Contains PSU NAMSTRT startup 
record. 

Contains SRB in ASCII 6/12 format. 

RBF5 Trace/Debug binaries. SYSGEN 
procedure SWAP is used to load these 
binaries . 

File 1. Contains RBF NAMSTRT startup 
record. 

File 1. Contains RDF startup procedure. 

File 1. Contains RHP NAMSTRT startup 
reco rd . 

Transaction Facility permanent files. 
File 1. TAF startup procedure. 
File 2. TASKLIB. 

Terminal Definition Utility Files. 
File 1. ULIB/TERMLIB. 
File 2. TDUIN file. 
File 3. TDUFILE. 

File 1. Contains XEDIT help file, 
XEDITH. 



On component orders, you also get the following files: 

PRODUCT Contains all binaries for the deadstart tape. 

DSTDIR Contains LIBEDIT directives for the products in file PRODUCT. 



BLDLIB 



Contains a procedure to properly update all ULIBs from 
binaries In file PRODUCT. 
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CONTROLWARE INSTALLATION 



Controlware for 834/844/885 mass storage and 639/667/669 magnetic tape devices is available 
on either punched cards or 9-track magnetic tapes. Cards are supplied with the standard 
release materials. If you want the magnetic tape versions, specify magnetic tape when 
ordering the controlware. The 819 Peripheral Processor Unit (PPU) driver is available only 
on magnetic tape. 



819 PPU DRIVER INSTALLATION 

The 819 PPU driver can be installed only on a model 176. The 819 PPU driver resides on the 
system as a PPU-type record named HCD and is loaded into the first-level peripheral 
processors (FLPPs) during deadstart. The installation procedure assembles the 819 driver 
from the release tape and copies the binaries to the permanent file PRODUCT. 

To build a system with a new 819 driver, submit a job similar to the following: 

job command. 

USER, username, password ,f amilyname. 

BEGIN , HCD , INSTALL . 

— eoi — 



NO™! 



This controlware can be received only if you 
order NOS on the OIP. 



834/844/885/895 CONTROLWARE INSTALLATION 

The 834/844/885/895 controlware resides on the system as a PPU-type record named BCS for 
half-track 7054/7152/7154 controlware, BCF for full-track 7152/7154 controlware, FMD for 
7155-1 controlware, PHD for 7155-401 controlware, MA464 for full-track 7165, ISD for full 
track 7255-1 controlware, or CMD for control module controlware; it is loaded into the 7054, 
7152, 7154, 7155-1 or 7155-401, 7165, 7255-1, or control module controller during system 
deadstart. To build a system with new controlware from either punched cards or magnetic 
tape, perform one of the following procedures. The procedures copy the 834/844/885/895 
controlware program from the released deck or tape to the permanent file PRODUCT. 



NOTE 



The 7255-1 and control module controlware 
are not available in card deck form. 
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PUNCHED CARDS 

| Submit the following job to install 834/844/885/895 controlware from cards. 

job command. 

USER , username , password , f ami 1 yname . 

NOTE,IN.+*COMMENT PPU/typ typ FIRMWARE xxxxx-xxx(PNxxxxxxx) 

COPYBF .INPUT , INHOLD . 

BEGIN , typ, INSTALL. 

— eor — 

|* 834/844/885/895 controlware deck 
— eoi — 

typ is the controlware type: 

BCS Half-track 7054/7152/7154. 
BCF Full-track 7152/7154. 
FMD 7155-1 
PHD 7155-401. 
I MA464 Full-track 7165. 

xxxxx-xxx(PNxxxxxxxx) is the number associated with the controlware. For example, if 
type is FMD, the number could be MG101-AOO(PN12345678). 



MAGNETIC TAPE 

I To install 834/844/885/895 controlware from magnetic tape, submit a job similar to the 
following. 



Job 

job command. 

USER, username , password , f amilyname. 

LABEL,TAPE,F=SI,NT,D=1600,LB=KU. 



Comments 



Before entering this command, the 844/885/895 
controlware tape should be mounted and ready on 
a 9-track tape drive. The tape must be assigned 
by the operator. 
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Job 



Comments 



NOTE , IN. +*COMMENT PPU/typ nn 



COPYBF , TAPE , INHOLD . 
RETURN, TAPE. 
BEGIN, typ, INSTALL. 

— eol — 



typ is the control ware type. 

BCS Half-track 7054/7152/7154. 

CMD Control Module. 

ISD Full-track 7255-1. 

MA464 Full-track 7165. 

BCF Full-track 7152/7154. 

FMD 7155-1. 

PHD 7155-401. 

nn Is the version of 844/885/895 controlware you | 
are installing. 

typ is controlware type (previously defined). 



NOTE 



The COPYBF command must be preceded by the 
command SKIPF,TAPE,1 if you are installing 
ISD controlware, and the command 
SKIPF,TAPE,2 if you are installing CMD 
controlware. 



639/667/669 CONTROLWARE INSTALLATION 

The 639 controlware resides on the system as a PPU-type record named CW63x; 667/669 
controlware resides on the system as a PPU-type record named FIRM66X. The controlware is 
loaded into the 7021 or 7152 controller at system deadstart and whenever the magnetic tape 
subsystem, MAG, is brought to a control point. To build a system with new controlware from 
either punched cards or 9-track magnetic tape, perform one of the following procedures. The 
procedures copy the 667/669 controlware program from the released deck or tape to the 
permanent file PRODUCT. 



NOTE 



CW63x controlware installation is performed 
in the same manner as the 834/844/885/895 
controlware. However, the COPYBF command 
must be preceded by a SKIPR,TAPE,1 when 
installing from tape. 
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PUNCHED CARDS 

Figure D-l illustrates the structure of the colds tart deck used to load the 639/667/669 
I controlware when deadstarting from 667 or 669 magnetic tape units (coldstart). 




Figure D-l. Coldstart Deck Structure 

There are two records in the coldstart deck, the automatic buffer controlware loader (ABC) 
program and the controlware deck. The program on the deadstart panel reads and executes 
ABC, which causes the controlware deck to be loaded. When controlware loading is complete, 
system or maintenance deadstart proceeds. 

Use the following job to add new controlware programs to the deadstart tape and also to 
obtain the coldstart deck. It collects the binary card deck for the 667/669 magnetic tape 
controlware program FIRM66X, installs the binaries on the permanent files used to create a 
new deadstart tape, and punches a coldstart deck. (This coldstart deck is also supplied 
with the released controlware.) 



Job 



Comments 



job command. 

USER, user name, password, familyname. 

NOTE,IN.+*COMMENT PPU/FIRM66X nn 

COPYBF , INPUT , INHOLD . 
BEGIN ,MTS , INSTALL . 
— eor — 

667/669 controlware deck. 
— eoi — 



nn is the version of 639/667/699 controlware 
being installed. 
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MAGNETIC TAPE 

To install 667/669 controlware from magnetic tape, submit a job similar to the following. 
Job Comments 

job command. 

USER, user name, password, family name. 

LABEL,MTSTAPE,F=L,NT,D=1600,LB=KU. Before entering this command, the 667/669 

controlware tape should be mounted and ready 
on a 9-track drive. The tape must be 
assigned by the operator. 

NOTE,IN.+*COMMENT PPU/FIRM66X nn nn is the version of the 667/669 controlware 

being installed. 
SKTPF.MTSTAPE. 

COPY .MTSTAPE , TEMP , TC =€0F , N=l , BS =1 0O0OB . 
RETURN, MTSTAPE. 
REWIND, TEMP. 
COPYBR, TEMP, INHOLD. 
BEGIN, MTS, INSTALL. 
RETURN, PUNCHB. 
— eoi — 

NETWORK ACCESS DEVICE (NAD) CONTROLWARE INSTALLATION 

NAD controlware resides on the system as a PPU-type record named 170 for NADs connected to 
CYBER 170 computer systems. Controlware named IBM for NADs connected to IBM systems and MIN 
for NADs connected to minicomputer (DEC) systems may also be installed on the system as a 
PPU-type record. It is loaded into the NADs during Remote Host Facility (RHF) 
initialization or on operator request. To build a system with new 170 NAD controlware or to 
install IBM, MIN, or 200 controlware from either punched cards or magnetic tape, perform one 
of the following procedures. The procedures copy the NAD controlware program from the 
released deck or tape to the permanent file PRODUCT. 



PUNCHED CARDS 

Submit the following job to install NAD controlware from cards. 

Job Comments 

job command. 

USER ,username , password , f amilyname . 

N0TE,IN.+*C0MMENT PPU/typ nn typ is the controlware type. 

170 CYBER 170 NADs. 

IBM IBM NADs. 

MIN Minicomputer (DEC) NADs. 

nn is the version of NAD controlware you are 
installing. 
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Job 

COPYBF , INPUT , INHOLD . 
BEGIN, typ, INSTALL. 

— eoi — 

NAD controlware deck. 
— eoi — 



Comments 



typ is the controlware type (previously 
defined). 



MAGNETIC TAPE 

To install NAD controlware from magnetic tape, submit a job similar to the following. 

Comments 



Job 

job command. 

USER, user name , password , f ami ly name . 

LABEL, TAPE, F=SI,NT,D=1600,LB=KU. 



NOTE,IN.+*CQMMENT PPU/typ nn 



COPYBF , TAPE , INHOLD . 
RE TURN, TAPE. 
BEGIN, typ, INSTALL. 
— eoi — 



Before entering this command, the NAD 
controlware tape should be mounted and ready 
on a 9-track tape drive. The tape must be 
assigned by the operator. 

typ is the controlware type. 

170 CYBER 170 NADs. 

IBM IBM NADs. 

MIN Minicomputer (DEC) NADs. 

nn is the version of NAD controlware you are 
installing. 

typ is controlware type (previously defined). 
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CONTROLWARE CARD DECK GENERATION 



To punch a controlware card deck, run the following job. 
Job 



Comments 



job command. 

USER, username, password, familyname. 

COMMON, SYSTEM. 

GTR , SYSTEM , FILE . PPU/ dname 



dname Is the name of the record containing 
the controlware desired. 



ATTACH, OPL=OPL. 
MODIFY, C,Z./*EDIT ABC 
COMPASS , I , S=NOSTEXT . 
COPYBR.FILE.LGO. 
ROUTE, LGO,DC=SB. 
— eoi — 



If OPL is on tape, use a LABEL command. 



Extract the first card from the resulting card deck before inserting the deck in subsequent 
jobs. 
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63-CHARACTER SET INSTALLATION 



If you want to install a system with the 63-character set format, you must perform the 
customized installation described in this appendix. 



DEDICATED SYSTEM 

To install a 63-character set format on a dedicated system using the released deadstart 
tape, follow these steps: 

1. After you load the files necessary for installation (refer to section 3), execute 
the following command to convert the Modify-f ormatted DECKOPL procedures to the 
63-character set format: 

BEGIN, SETUP, INSTALL, CV63.NEWPL. 

2. Run the UCOMMOD procedure to recreate file COMMOD. Use the new COMMOD file to set 
your DECKOPL installation defaults. 

3. Execute the following command to rebuild the INSTALL procedure file to include code 
for a 63-character set installation: 

BEGIN , SETUP , INSTALL ,DF63 , INSTALL ,MOD=COMMOD . 



NOTE 



Any future calls to SETUP should include the 
DF63 parameter. 



4. Run the SEED procedure. 

5. Create file USER for the MODOPL procedure, if needed. 

6. Execute the MODOPL procedure. The composite OPL is created in the 63-character set 
format. 

7. Deadstart the system again using this IPRDECK entry: 

CSM=63. 

8. Include the parameter CSET=C63 or CSET=A63 on the call to build TEXT. 

9. Continue with the installation. 
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PRODUCTION ENVIRONMENT 

To install a 63-character set format in a production environment system (assuming that the 
running system is in 63-character set format), follow these steps: 

1. Before executing the MODOPL procedure, execute this command: 

BEGIN , SETUP , INSTALL , DF 63 , INSTALL . 

2. Run SEED procedure. 

3. Execute the MODOPL procedure. 

4. Include the keyword CSET on the call to build TEXT. 

5. Continue with the installation. 



FILE CONVERSIONS FOR BOTH DEDICATED AND PRODUCTION SYSTEMS 

All text files that are installed by SYSGEN should be converted to 63-character set format. 
Use the FCOPY command to convert the files. For example, the FSEPROC file would be 
converted with this command: 

FCOPY (P-FSEPROC , PC=DIS64 , N=newf ile ,NC=ASCII63 ,R ) 

The Full Screen Editor help file, FSEHELP, would be converted by this command: 

FCOPY (P=FSEHELP,PC=ASCH64,N=newfile,NC=ASCII63,R) 

The following files are installed by SYSGEN and must be converted to 63-character set format 
because they are not recreated from the build jobs. 

• On user name LIBRARY, convert the ASCII 6/12 files FSEHELP, FSTEACH, TDUIN, TDUFILE, 
and HELPLIB. Convert the display code file FSEPROC. * 

• On user name INSTALL, convert display code files USERBPS, SMFSTAT, NDLDATA. PSRRPT 
and ASCII 6/12 file SRB. 

Because HELPLIB is a ULIB file, you must first GTR all PROCs from the file, convert them 
with FCOPY, and then re-LIBGEN the file. 



PRINTER SUPPORT UTILITY 

The Printer Support Utility (PSU) is released in binary format only. The X. SYSGEN (SWAP) 
procedure enables 63-character set customers to use PSU by loading a 63-character set 
version of PSU from the permanent file tapes. You can load a trace or nontrace version of 
PSU. Here's the format for the command: 

X. SYSGEN(SWAP, dd ,PSU , , , type ) 

Replace dd with the tape density of the deadstart tape that will be built; replace type 
with T63 to load a trace version or NT63 to load a nontrace version. 

This procedure will build a new deadstart tape containing your running system plus the 
63-character set PSU binaries. To use this procedure you must use SYSGEN(FULL) to load the 
RECLAIM database and you'll need to mount the permanent file tapes. There is no provision 
for restoring the original 64-character set version, so be sure to keep a copy of your 
original deadstart tape. 
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THE REMOTE DIAGNOSTIC FACILITY 



The Remote Diagnostic Facility (RDF) allows you to use an interactive terminal when your 
networks are not yet installed. Thus, you can use the RDF as an interface for using a NOS 
editor to create your deadstart deck files or configuration files. 

To initiate RDF, follow these steps: 

1. When you are deadstarting the system, make an EQPDECK entry that defines the 
two-port multiplexer to which the terminal you want to use is connected. (Check 

with your customer engineer (CE) to ensure that the terminal's baud rate agrees with | 
that set on the two-port multiplexer. Refer to the NOS 2 Analysis Handbook for the 
syntax of the entry. ) 

2. After you have deadstarted the system, check the operator E,A. display for the 
equipment status of the two-port multiplexer. If the status is OFF, enter this 
command : 

ON.nn 

nn The EST ordinal of the two-port multiplexer. 

3. Enable the RDF subsystem by entering these commands: 

SUBSYST. 

L. ENABLE, RDF. 

L.END. 

4. Now initiate RDF by entering this command: 

RDF. 

5. Press the RETURN key on the terminal a few times; the login banner is displayed at 
the terminal. 

Using RDF is similar to using IAF/NAM, with the following exceptions: 

To correct input, press the backspace key or CTRL-H. 

To delete input, press the ESCAPE key. 

To interrupt execution, press I or the BREAK key. 

To terminate execution, press S or enter STOP. 

To exit TEXT mode, press CTRL-C or the BREAK key. 

The typing-ahead feature is not available on RDF. 

Full Screen Editor (FSE) does not function properly. 
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SYSTEM CONFIGURATIONS 



To minimize installation time and confusion and to establish conventions which will enable 
better CDC service/support to users, the preferred configurations have been defined in table 
G-l. 

Complete configurations are not defined in table G-l due to the differing customer 
requirements . Conventions are specified for a base system. Systems configured according to 
the conventions will provide the following benefits: 

• Simplify the selection of peripheral equipment channels by the customer and customer 
engineering. 

• Allow the customer to easily deadstart NOS using the pre-defined configurations 
released on the deadstart tape. 
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Table G-l. Preferred Configuration 



Channel 


CYBER 170/180-800 Models 
815, 825, 835, 840, 845 
850, 855, 860, 865, 875 


CYBER 180 Models 
810, 830 


a 


b 


c 




1 

2 

3 

4 

5 

6 

7 

10 

11 

12 

13 

20 

21 

22 

23 

24 

25 

26 

27 

30 

31 

32 

33 


+ 
ROTATING MASS STORAGE (RMS)! 
RMS 2 
RMS 3 
RMS 4 
COMMUNICATIONS! 
COMMUNICATIONS 2 
COMMUNICATIONS 3 
CONSOLE 
MAG TAPEj 
UNIT RECORD 
+ 
+ 
RMS 5 
RMS 6 
RMS 7 
RMSg 
+ 
+ 
+ 
+ 
MAG TAPE3 
MAG TAPE4 
MAG TAPE 2 


RMS-ISD! 

+ 

+ 
+ 

MT-ISMTj 

COMMUNICATIONS 

CONSOLE* 

+ 
+ 

RMS-ISD 2 

+ 

+ 
+ 

ISD/ISMT 

+ 

+ 
+ 


RMS-ISDx 
RMS! 

RMS 2 
RMS3 

MT-ISMT! 
COMMUNICATIONS! 
CONSOLE* 
+ 
UNIT RECORD 

RMS-ISD2 
RMS4 

+ 

+ 
COMMUNICATIONS 2 
ISD/ISMT 

+ 
MAG TAPE! 
MAG TAPE 2 

+ 


RMS-ISD! 
RMS-ISD3 

RMS-ISD4 

+ 

MT-ISMT! 

COMMUNICATIONS 

CONSOLE* 

+ 
+ 

RMS-ISD 2 

+ 

+ 
+ 

ISD/ISMT 

+ 

+ 
+ 


a: Specifies channel assignments for a 810/830 using only Intelligent Small Disk (ISD) 
and Intelligent Small Tape (ISMT) disk and tape peripherals. 

b: Specifies channel assignments for a 810/830 with both ISD/ISMT peripherals and other 
CDC disk and tape peripherals. 

c: Specifies channel assignments for the C180-810 and 830 with the 18102-2 channel 
option. 

+: Indicates that the channel is available for CYBER channel peripheral connection. 

-: Indicates that the channel is not available CYBER channel for peripheral connection. 

*: 18002-1 console only. 
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INDEX 



AAM2 procedure 

Additional procedures 5-5 

Compression/decompression 5-5 

File statistics 5-5 

References TEXT and TEXTIO 5-173,174 

Unique parameters 5-5 

USER file directives 5-5 
Advanced access methods, CYBER record manager 

(see AAM2 procedure) 
ALGOLS procedure 

References TEXT and TEXTIO 5-173,174 
ALGOL 60 version 5 (see ALG0L5 procedure) 
APL2 procedure 

APLO and APL1 procedures 5-9 

Entry message 5-8 

References TEXT and TEXTIO 5-173,174 

SYSGEN functions for 5-8 
ASMOVE utility parameters 5-138 
Auxiliary PL assignments B-ll 
Auxiliary program libraries B-ll 



BAM procedure 

Installation parameters 5-10 
References TEXT and TEXTIO 5-173,174 

Basic access methods, CYBER record manager 
(see BAM procedure) 

BASIC3 procedure 

Installation parameters 5-11 
References TEXT and TEXTIO 5-173,174 

Batch I/O parameters 5-126 

BSTP=bstp parameter 5-22 

Building products Process 4-2 



Carriage return 6 

CCL procedure 

Installation parameters 5-12 
Additional procedures 5-13 

CCP/CROSS installation 

Binary installation option 5-20 
Build step description 5-16 
Calling the build procedures 5-21 
CCP/CROSS permanent files 5-34 
CCP load file definition 5-42 
CCP system definition 5-38 
CCP variant and load module 5-39 
CCPBLB CCP installation 5-29 
CCPEDIT CCP installation 5-31 



CCPLOAD CCP installation 5-32 
CCPPH1 CCP installation 5-27 
CCPPURG CCP installation 5-33 
CCPVAR CCP installation 5-30 
Hardware requirements 5-14 
CCP/CROSS permanent files 

Absolute load files 5-34 
Binary library file 5-35 
CCP load file 5-35 
CCP/CROSS listings files 5-35 
Corrective code file 5-35 
Program libraries 5-35 
Symbol tables 5-35 
User-supplied files 5-36 
CDCS2 procedure 

Accounting table 5-65 
CDCS2 procedure file 5-65 
Special notes 5-65 
Unique parameters 5-64 
Verification 5-67 
CE (see Customer engineer) 
Central memory 6 

Central site batch I/O parameters 5-126 
CID procedure 

Installation parameters 5-68 
CIP (see CYBER Initialization Package) 
CMM (see UPDATE procedure) 
CMRDECK 2-3 
COBOL5/COBOL5Q procedures 
Defined 5-69 

Installation parameters 5-70 
References TEXT and TEXTIO 5-173,174 
Unique parameters 5-69 
C0MEIPR parameters 5-124 
C0MMOD file parameters B-2 
Common common decks 5-17 
Common deck parameters 
COMEIPR 5-124 
COMSACC 5-124 
COMSBIO 5-126 
COMSIOQ 5-126 
COMSJIO 5-126 
COMSLSD 5-127 
COMSMLS 5-127 
COMSMSC 5-128 
COMSMTX 5-129 
COMSPFM 5-130 
C0MSPR0 5-133 
COMSREM 5-133 
COMSRSX 5-134 
COMSSCD 5-135 
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COMSSFS 5-135 
COMSSRU 5-135 
COMSSSJ 5-135 
COMS1DS 5-136 
COMTNAP 5-136 
COMUSIT 5-138 
COMXIPR 5-139 
PPCOM 5-139 
Common memory manager (CMM) (see UPDATE 

procedure) 
Common utilities, CYBER (see UPDATE 

procedure) 
Communications control program (see 

CCP/CROSS installation) 
Communications supervisor (see CS 

command) 
Component order 
Defined 2-1 
Installing 2-8; 3-1 
(see also SYSGEN( UPGRADE)) 
Composite OPL 

Modifying 3-7 
Compression/decompression routine, AAM 5-5 
COMSACC parameters 5-124 
COMSBIO parameters 5-126 
COMSIOQ parameters 5-126 
COMSJIO parameters 5-126 
COMSLSD parameters 5-127 
COMSMLS parameters 5-127 
COMSMSC parameters 5-128 
COMSMTX parameters 5-129 
COMSPFM parameters 5-130 
COMSPRO parameters 5-133 
COMSREM parameters 5-133 
COMSRSX parameters 5-134 
COMSSCD parameters 5-135 
COMSSFS parameters 5-135 
COMSSRU parameters 5-135 
COMSSSJ parameters 5-135 
C0MS1DS parameters 5-136 
COMTNAP parameters 5-136 
COMUSIT parameters 5-138 
COMXIPR parameters 5-139 
Configuration files 
LCF 2-6 
LIDCMid 2-6 
MAS 2-6 
NCF 2-6 
RCFMid 2-6 
Controlware installation D-l 
CR (see Carriage return) 
Creating a deadstart file 
Steps 2-7; 4-17 
Using local files 2-9 
Using tapes 2-9 

(see also GENDST procedure and SYSGEN) 
CROSS procedure 

Input files 5-25 



Output files 5-25 
CS command 5-115 
CSET parameter 

For TEXT/TEXTIO 5-173 
Customer engineer 

Installing CIP 1-2 
Customized installation 

Defined 1-1 

Preparing for 3-1 

Steps 4-1 
CYBER channel conventions G-l 
CYBER Cross System and Communications 

Control Program (see CCP/CROSS 
installation) 
CYBER Initialization Package (CIP) 1-2 
CYBER 180-class machines 6 



Database control system, CYBER (see CDCS2 

procedure) 
Dayfile/QPROTECT equivalences 5-126 
DCL procedure 

Product dependencies 5-71 
SYSGEN functions for 5-71 
Deadstart decks 
CMRDECK 2-3 
EQPDECK 2-3 
IPRDECK 2-3 
LIBDECK 2-3 
Deadstart file 
Contents 1-1 
Creating 2-7; 4-17 
Defined 1-1 
Deadstart process 2-3 
Deadstart tape (see Deadstart file) 
DEBUG parameter 

For CDCS2 5-64 
For RHP 5-154 
For TAF 5-159 
DECKLIS procedure B-8 
DECKOPL (see Installation procedures) 
Dedicated system 3-2 
Dependencies between jobs 4-4 
DIAG-diag parameter 5-22 
DIRFILE 

Defined 3-6 

(see also SEED procedure) 
Disk installation B-9 
DISKINS parameter B-3 
DSD parameters 5-139 



ECS (see Extended memory) 
ECS parameter 

For TEXT/TEXTIO 5-173 
Enable subsystems 5-2 
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ENTER macro parameters 5-139 

EQPDECK 

Description 2-3 

Range of EST ordinals 5-139 

(see also CYBER channel conventions) 

ESM (see Extended memory) 

ESMX parameter 5-139 

EXPAND (see USERBPS file) 

Extended core storage (see Extended memory) 

Extended memory 6 



FDBF procedure 5-72 

Product dependencies 5-72 

Unique parameters 5-72 
Field length for MODVAL and 
PROCFILE commands 5-135 
File formats C-l 

File transfer facility (see RHP procedure) 
FLMSG parameter 

For LOADER 5-89 
FORTRAN extended 4 (see FTN procedure) 
FORTRAN extended 4 with interactive option 

(see FTNTS procedure) 
FORTRAN 5 (see FTN5 procedure) 
FSE procedures 

FSEEX and SMFEX 5-73 

Installation parameters 5-75 

SMF procedure file 5-74 

SMSSTAT 5-76 

SYSGEN functions for FSE 5-75 

(see also Subsystem initiation) 
FTN/FTNTS/FTN5 procedures 

Installation parameters 5-77 

Integer multiply FCOs 5-78 

MODEL parameter 5-77 
FTN4 parameter 

For FDBF procedure 5-72 
Full product order 

Defined 2-1 

Installing 2-2 
Full Screen Editor 

(see FSE procedure) 



GENDST procedure 


B-12 


GLOBLIB file 




Defined 3-6 




(see also SEED 


procedure) 


GN=file parameter 


5-22 


Group 1 Products 


4-7 


Group 2 Products 


4-9 


Group 3 Products 


4-10 


Group 4 Products 


4-11 


Group 5 Products 


4-12 


Group 6 Products 


4-13 



Hardware features 5-173 
HF.LIST parameter 5-176 



IA parameter B-3 

IAF common deck parameters 5-133 

IAF procedure 

IAF procedure file 5-80 

Installation parameters 5-80 

Special notes 5-81 

(see also Subsystem initiation) 
IBs (see Installation bulletins) 
ICHG parameter B-3 
IFAMILY parameter B-3 
IMF parameter 

For QUE 5-145 
IMF1 procedure 

Product dependencies 5-82 

Unique parameters 5-82 
Information management facility (see IMF1 

procedure) 
Installation 

Customized 3-1 

Dedicated system 3-2 

Disk B-9 

Procedure names 4-7 

Production system 3-3 

Standard 2-1 

User names 2-5; B-17 
Installation bulletins 1-3 
Installation procedures 

Customizing 3-4 

(see also COMMOD file parameters, 
DECKLIS procedure, and SETUP 
procedure file) 
Interactive debug, CYBER (see CID procedure) 
Interactive facility (see IAF procedure) 
Interactive transfer facility (see ITF 

procedure) 
I.PARAMS symbols 

HF.LIST 5-176 

IP.CMU 5-174 
5-174 
5-175 
5-175 
5-175 



IP.CSET 

IP.MECS 

MODEL 

OS. ID 
IPRDECK 2-3 
IPW parameter B-4 
ITF command 5-84 
ITF procedure 

ITF command 5-84 

ITF shutdown 5-85 

Product dependencies 
IUCHG parameter B-4 
IUN parameter B-4 



5-83 
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Job dependencies 4-2 
JOB directive 

For network startup 5-107 
Job resource limits parameters 
Job skeleton records 5-108 



5-134 



L-display buffer parameters 5-139 
Label sectors of mass storage 5-127 
Large central memory extended (see Extended 

memory) 
LCF (see Configuration files) 
LCS3/FCS3 procedures 

Table sizes and CM requirements 5-86 

USER file directives 5-86 
LIBDECK 2-3 
LIDCMid 

(see Configuration files) 
LIST=f ilename parameter B-4 
LIST»option parameter 

For CCP 5-22 
Listing installation procedures (see DECKLIS 

procedure) 
LOADER procedure 

Installation parameters 5-90 

Unique parameters 5-88 
Local configuration file 2-6; 5-100 
Logical identifier configuration file 2-6 



Magnetic tape parameters 5-129 
MAP parameter 

For LOADER 5-88 
MAP subsystem (see MSSI procedure) 
MAS procedure 

MAS configuration file 5-92 

MAS procedure file 5-92 

Unique parameters 5-92 
Mass storage devices 

Number of 5-139 
Mass storage subsystem parameters 5-124 
MCS procedure 

Installation parameters 5-93 

MCS procedure file 5-94 

Special notes 5-95 

Unique parameters 5-93 

Verification 5-96 
MFT parameter 

For TEXT/TEXTI0 5-173 

(see also MODEL parameter) 
MISCGET procedure B-13 
MLTF initiation procedure 5-152 
MODEL parameter 

For FORTRAN 5-77,79 

For TEXT/TEXTIO 5-175 
M0D0PL procedure 3-7 



Moving files (see SYSGEN(MOVE)) 

MSS procedure 

MSS procedure file 5-97 

Unique parameters 5-97 

(see also Subsystem initiation) 

MSSI procedure 

Installation parameters 5-98 
Procedures for initiating 5-98 
(see also Subsystem initiation) 

Multirecord security parameters 5-127 



NAD controlware initialization 5-152 
NAD controlware installation D-5 
NAM5 procedure 

Configuration files 5-100 
NAM procedure file 5-101 
Network startup file 5-105 
Special notes 5-99 
SYSGEN functions 5-121 
Unique parameters 5-100 
USER file directives 5-102 
NCF (see Network configuration file) 
Network access method (see NAM5 procedure) 
Network applications accessible to 

users 5-136 
Network configuration file 2-6; 5-100 
Network interface program (NIP) (see NIP 

command) 
Network Operating System (see NOS procedure) 
Network processing unit variants 2-6 
Network supervisor (NS) (see NS command) 
NEW-yyy parameter 5-22 
NIP command 5-117 
NOCDCS parameter 

For C0B0L5 5-69 
N0ECS parameter 5-22 
N0PURGE parameter 5-22 
NOS procedure 

Modifying parameters 5-122 
(see also MODOPL procedure) 
NOTRACE parameter 

For NAM procedure 5-100 
For RBF5 5-146 
N0WRT=nn parameter 5-22 

NPUs (see Network processing unit variants) 
NS command 5-119 
NSS procedure 

Accounting for SPOTs 5-141 
Installation parameters 5-142 
SPOT memory requirements 5-140 



OIP (see Order information package) 
0LD=xxx parameter 5-23 
Online manual files 
Installing 2-5 
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Operating system (see NOS procedure) 
Order information package (OIP) 1-1 
OS. ID parameter 5-175 
OUTPRD parameter B-5 



PARAM directive 

For network startup 5-107 
Parameter records 

For NAMI 5-105 
PC=pc parameter 5-23 
PCKNAM parameter B-5 
Permanent file environment 

Setting up 3-2 

(see also SYSGEK) 
Permanent file symbols 5-130 
Permanent file tapes 

Contents 1-2 
Permanent file transfer facility (PTF) (see 

RHP procedure) 
PFLOAD B-9 

PPCOM parameters 5-139 
Preconf igured deadstart decks 2-3 
PRESET parameter 

For LOADER 5-88 
PRID parameter B-5 
PROCFILa parameters 5-133 
Product dependencies 4-2 
PRODUCT file 

Defined 3-6 

(see also SEED procedure) 
Production system 

Defined 3-2 

Steps for installing on 3-3 
Programming Systems Report (PSR) 1-3 
PSR (see Programming Systems Report) 
PSRIN parameter B-5 
PSROUT parameter B-6 
PTF (see RHP procedure) 



QTF (see RHP procedure) 

QTF initiation 5-157 

Query update (see QU3 procedure) 

Queued file transfer facility (QTF) (see RHP 

procedure) 
QU3 procedure 

Unique parameters 5-145 



RBF command 5-146 

RBF5 procedure 

File placement 5-148 
RBF command 5-146 
Unique parameters 5-146 
USER file directives 5-147 
Verification 5-149 



RCFMid (see RHF configuration file) 
RDF (see Remote diagnostic facility) 
RECLAIM database (RECLDB) 

Loading 3-3 

(see also SYSGEN( SOURCE) and 
SYSGEN(UPGRADE)) 
RECLDB (see RECLAIM database) 
Record manager (see AAM2 and BAM procedures) 
Release bulletins 

IBs 1-3 

SRBs 1-3 
Release materials description C-l 
Remote batch facility (see RBF5 procedure) 
Remote diagnostic facility F-l 
Remote host facility (see RHF procedure) 
Remote host products (see RHP procedure) 
REPORT procedure B-14 
RESETP B-14 
RESOUR parameter B-6 
RHF procedure 

Hardware configuration 5-151 

Installation parameters 5-151 

LIDs 5-152 

Loopback capabilities 5-153 

RHF configuration file 5-150 

RHF procedure file 5-150 

Store and forward capabilities 5-153 
RHP procedure 

Installation parameters 5-156 

QTF initiation procedure 5-157 

Unique parameters 5-154 



SAVELIB parameter 

For MAS 5-92 

For MSS 5-97 
Screen management facility (SMF) (see FSE 

procedures) 
Secure login 5-23 
Security characters 

For TIPS 5-23 
SEED procedure 3-6 
Service class definitions 5-135 
SETUP procedure B-15 
SMF procedure file (see FSE procedures) 
SMFSTAT procedure (see FSE procedures) 
Software release bulletin 1-3 
SOLVER 1-3 
SORT procedure 

Hardware requirements 5-158 

USER file directives 5-158 
Source files C-2 

SRBs (see Software release bulletin) 
SRT4 parameter 

For AAM2 5-5 

For CDCS2 5-64 

For C0B0L5 5-69 



60459320 E 



Index-5 



For TMF1 5-82 

For QU3 5-145 
SRU calculations parameters 5-135 
SSF subsystem (see Subsystem initiation) 
Standard installation 2-1 
SUBSYS =subsys parameter 

For RHP 5-154 
Subsystem initiation 

Automatic initiation 5-2 

Defined 5-2 

Special notes 5-4 

Startup files 5-2 
Subsystems 

Initiating 5-2 

List of 5-3 
SYSGEN 

Command B-16 

Functions B-18 

Maintenance B-17 

User names 2-5; B-17 

Validations B-16 
SYSGEN(COPYSYS) B-18 
SYSGEN(COPYTAP) B-19 
SYSGEN(DST) B-19 
SYSGEN(FILES) B-20 
SYSGEN(FULL) B-20 
SYSGEN(MOVE) B-20 
SYSGEN( RECLAIM) B-21 
SYSGEN( SOURCE) B-21 
SYSGEN(SWAP) B-22 
SYSGEN( UPGRADE) B-22 



TAF parameter 

For C0B0L5 5-69 
TAF procedure 

Installation parameters 5-161 

TAF procedure file 5-160 

Task library 5-159 

Unique parameters 5-159 
TASKLB parameter 

For TAF 5-159 
TDU procedure 5-171 
TERMTYP=termtyp parameter 

For APL2 5-8 
TEXT/TEXTIO procedures 

Installation parameters 5-174 



Unique parameters 5-173 
TITLE statement 

For network startup 5-105 
TOBLD parameter B-6 
TOLIST parameter B-6 
TRACE parameter 

For MCS 5-93 

For RHP 5-154 



Unified extended memory (UEM) (see Extended 

memory ) 
Unique parameters 

Installation procedures 4-2 
UNI parameter B-7 
UN2 parameter B-7 
UPDATE procedure 5-179 
Updating the RECLAIM database 2-8 

(see also SYSGEN( UPGRADE) 
USER files 

Contents 3-5 

Creating 3-5 

USERF parameter 3-5 
User validation limits 5-124 
USERBPS file 5-37 
USERF parameter (see USER files) 



Validation and project profile files 
Verification procedure names 4-19 
Verify CCP installation 4-20 
Verify installation 4-17 
Verify NAM installation 4-20 
Verify RHF installation 4-23 
VFYTAPE parameter B-7 



B-17 



XEDIT procedure 5-180 
XTRAPLS-xtrapls parameter 



5-23 



63-character set installation E-l 
639/667/669 controlware D-3 
834/844/885/895 controlware D-l 
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